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FEATURES 


IMPLICIT SURFACES AND REAL-TIME GRAPHICS 

by Kyle Lussier 

Implicit surfaces are used in molecular modeling, animation, geophysical systems, 
weather analysis, and the like. They’re also at the heart of Silly Space, the modeling 
application Kyle describes here. 


A MEMORY-CONSTRAINED IMAGE-PROCESSING ARCHITECTURE 
by Mayur Patel 

Image-processing applications are hungry for both processing time and memory. The 
architecture Mayur presents here puts you in the driver’s seat when it comes to 
controlling memory consumption for high-performance image processing. 


RAVEKIT: A PORTABLE GRAPHICS FRAMEWORK 

by Mark Carolan 

RaveKit, Mark’s general-purpose, cross-platform framework, lets you create interactive 
3-D environments that provide an alternative way of presenting graphical data and 
obtaining user input. 


MOTION BLUR EFFECTS 

by Tim Wittenburg 

Altering the appearance of “moving” objects using blurring techniques can add tealism 
and excitement to your graphic images. Tim shows you one way to accomplish this. 


TREAPS IN JAVA 

by Stefan Nilsson 

Treaps, the randomized search trees devised by C.R. Aragon and R. Seidel, provide the 
functionality of a general-purpose sorting routine, priority queue, hash-table, stack, or 
standard queue. Stefan shows you how to implement treaps in Java. 
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by John Calcote 
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EMBEDDED SYSTEMS 


ATMEL’S AT89C2051 MICROCONTROLLER 46 











Thanks to Kyle Lussier for the penguin on our cover. 


Dhananjay presents a simple programmer for AT89C2051 that is hosted on a 8052-based 
circuit running a Basic interpreter. He then uses the system to build a 12-bit 
multichannel ADC to connect to PCs. 


INTERNET PROGRAMMING 
THREAD POOLS AND SERVER PERFORMANCE 60 


As John points out here, thread pools provide one way of improving server 
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PROGRAMMER'S TOOLCHEST 


SOUNDING OFF WITH THE RSX LIBRARY 

by Steve Durham 

Intel’s Realistic Sound Experience (RSX) library was initially developed to enhance the 
silent 3-D world of VRML. Steve presents WaveSpinner, an RSX-based tool that reads a 
script, animates and spatializes all the sounds using RSX, and writes the result to 

a .WAV file. 


TECATE AND INTERACTIVE 3-D 

by Peter D. Kochevar 

By providing a set of tools for describing animated 3-D scenes and their interaction with 
end users, the Tecate system enables the description of interactive, animated 3-D scenes, 
and interfaces to existing applications and data sources such as the World Wide Web 
and remote collaboration. 


COLUMNS 


PROGRAMMING PARADIGMS 
by Michael Swaine 
Michael returns to the topics of Java bashing, Java books, and JavaBeans. 


C PROGRAMMING 

by Al Stevens 

In rethinking the relationship between C and C++, Al wonders if it is time to put the 
proverbial cart before the horse. 


JAVA Q&A 


by Cliff Berg 
Cliff uses the JDK 1.1 multilanguage feature to create a multilingual currency calculator. 


ALGORITHM ALLEY 

by Will Schroeder and Tom Citriniti 

Polygon decimation algorithms reduce the number of polygons in a mesh while 
maintaining a good approximation to the original data, leading to faster, more realistic 
3-D graphics. Will and Tom show how these algorithms are used and create a 
decimated VRML file. 


UNDOCUMENTED CORNER 

by Robert R. Collins 

Robert discusses the basics of in-circuit emulation, describing how it has become his 
primary software debugging tool. 


PROGRAMMER’S BOOKSHELF 

by Gregory V. Wilson 

This month, Greg examines Jonathan Rosenberg’s How Debuggers Work, Mark 
Woodman’s Programming Language Choice, and The Media Equation, by Byron Reeves 
and Clifford Nass. 
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online. To order the disk, send $14.95 
(California residents add sales tax) to Dr. 
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Random 
Readings 





Himmelfarb bemoans the convergence of education, learning, and the Internet. In an essay 
entitled “Revolution in the Library,” Himmelfarb, a professor emeritus at the City University of 
New York and author of The De-Moralization of Society: From Victorian Virtues to Modern Values, 

notes that, while computers and the Internet are providing unparalleled access to information, 
they are also changing the very nature of learning and education. From Himmelfarb’s perch, what 
the electronic revolution is fostering, teachers are allowing, and students are flocking to is a cut- 
and-paste approach to learning, where students glue together ideas and concepts without 
thinking things through. 

Borrowing from the jargon of software development, the phenomena Himmelfarb describes 
could easily be dubbed “component-based learning.” With this model, information— whether it 
be GUI controls or demographic surveys— is grabbed off the Internet and plugged into a 
framework of one kind or another. Among other advantages, component-based assembly requires 
less time and skill. Consequently, everything from automobiles to houses are assembled with 
premanufactured parts. Of course, applying this model to the assembly line is one thing; using it 
to mold young minds is quite another. 

Himmelfarb does admit she is of two minds about this electronic revolution. On the one hand, 
she applauds the “democratization of access to knowledge,” as does anyone who’s accessed a 
major research library without leaving home. Himmelfarb is quick to note, however, that this 
should not be confused with “democratization of knowledge itself.” She goes on to say that, 
unfortunately, “this is where the Internet... may be misleading and even pernicious, [because] in 
cyberspace, every source seems as authoritative as every other.” 

Therein lies the rub: The problem isn’t with students having access to 11 billion words and 22 
million web pages, but with their ability to weigh the value of the information they encounter. 
Lacking the intellectual tools for critically evaluating information, too many people— students and 
otherwise— end up assigning value to the quantity of amassed facts, rather than their quality. 

This is neither a problem that technology causes, nor one it can solve. Although marketers 
would have you believe otherwise, fundamental knowledge and skills are required for 
component-based anything. Just as programmers need to know about data structures and 
algorithms before building apps using tools such as Visual Basic, PowerBuilder, or Delphi, 
students need to know how to think critically before they can effectively use the Internet as a 
research tool. 

Fundamental skills in critical thinking eventually led Borge Nodland and John Ralston to 
publish a paper entitled “Indication of Anisotropy in Electromagnetic Propagation over 
Cosmological Distances” in Physical Review Letters (April 21, 1997). In their paper, Nodland and 
Ralston brought into question Albert Einstein’s Theory of Relativity, which assumes a constant 
speed of light and a centerless, directionless universe. 

When working on his Ph.D. at the University of Kansas, Nodland discovered that radio waves 
apparently rotate through space in a corkscrew pattern. In conjunction with Ralston (his advisor), 
Nodland (now at the University of Rochester) further found that radio waves traveling along the 
axis between the constellations Sextans and Aquila travel faster than those traveling at right angles 
to the axis. What this suggested is that the universe, like the Earth, may have its own axis—a 
notion contrary to Einstein’s relativity theory. The research also brought into question Einstein’s 
theories concerning the constant speed of light in a vacuum. 

Both researchers emphasize that there are a number of other possible interpretations of the 
data, and that the effect of this universal axis is so small that their findings do not necessarily 
contradict previous findings. And you can bet fellow researchers will apply the same critical 
evaluations to Nodland and Ralston’s theories that they applied to Einstein’s. 

Critical thinking skills must have been on hold when, according to the New York Times (April 
28, 1997), the U.S. Patent Office granted patent 5,600,836, a “System and Method for Processing 
Date-Dependent Information which Spans One or Two Centuries’”— the Year 2000 problem, in 
other words. 

Rather than changing millions of lines of program code, the technique Harvey Alter “invented,” 
and for which he was granted a patent, focuses on the data. “My idea is not to change the 
programs at all, but just subtract 20 or more years from all the dates in the data files,” says Alter. 
“Then the relationship between the dates remains the same.” All you really have to do, according 
to Alter, is turn back the system clock— and then pay him a royalty, of course. 

A thumbs-up to Alter for creative thinking. Two thumbs-down to the Patent Office for the lack 


of critical thinking. 


Jonathan Erickson 
editor-in-chief 


n the Spring 1997 issue of The American Scholar, historian and social observer Gertrude 
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C++Builder 

Dear DDJ, 

As a former Borlander and a member of 
the Delphi 1.0 development team, I would 
like to correct a misstatement Al Stevens 
made in his “C Programming” column 
(DDJ, May 1997). 

Zack Urlocker was indeed the project 
manager for Delphi, but he was not the 
main developer. That honor goes to An- 
ders Hejlsberg, who was the original au- 
thor of Turbo Pascal and the architect and 
lead developer of releases 1 and 2 of Del- 
phi, before he defected to Microsoft a few 
months ago. 

Incidentally, Delphi never had the code 
name Ivory, although a wide variety of 
code names were used for the beta ver- 
sions distributed under NDAs (so that Bor- 
land could detect the source of any leaks). 

I've used both languages extensively, 
and I think if Al were to overcome his 
prejudice and take the plunge, he would 
find that Object Pascal is at least as good 
a language as C++ for application devel- 
opment, and arguably a better one. 

Mike Harrison 

San Jose, California 

mikeh@slip.net 


Al responds: Mike, thanks for straightening 
me out on Anders. Overcome my preju- 
dice? I didn’t think I had one. I looked over 
what I wrote and couldn't find any Pascal 
bashing there. I apologize if it sounded like 
that. I disagree with your assessment of the 
relative merits of the two languages, though; 
but I think of it more as a preference than 
a prejudice. The industry seems to agree 
with me. But I think it’s great that we now 
have the neat Delphi platform for both lan- 
guages so everybody can be happy. Again, 
many thanks for your comments. 


Dear DDJ, 

I read Al Stevens’ “C Programming” col- 
umn about C++Builder (DD/J, May 1997). 
I, too, tried the beta version and fell in 
love with it. I purchased it as soon as it 
was available. It will certainly be a hit. It’s 


10 





nice to have the advanced feature of C++ 
combined with a wonderful development 
environment for once. 

One thing about Al’s column that sur- 
prised me was his disinterest in Delphi. 
After five years of C++ development, I 
was not interested in Delphi either, at 
first. Until a recent project at IBM, I was 
given a choice of any 16-bit tool I want- 
ed, except VB 4.0, which was too slow. 
After trying to go back to VC++ 1.52, I 
was so repulsed by the lack of features 
that I was accustomed to from VC++ 4.2 
that I tried my only alternative, Delphi. 
I was turned off by having to use Pas- 
cal, but there is no comparison to VC++ 
1.52 in terms of features and ease of use. 
The thing that changed my opinion was 
the almost instantaneous compile times. 
The compile times, in conjunction with 
support for object-oriented features and 
low-level support, make it such a great 
product. For a small- to mid-sized pro- 
ject, the thing takes only 3—5 seconds 
to build and run! The only thing I real- 
ly miss dearly is support for templates. 
Maybe it’s not possible because Pascal 
doesn’t have a precompiler. At least now 
that C++Builder is here, I can use tem- 
plates again. With the new incremental 
compiler and linker, it at least seems fast 
sometimes. I love the advanced features 
of C++, but if you need speed, you can't 
beat Delphi. 

John Bloch 

Bloch-head@worldnet.att.net 


Dear DDJ, 

As someone who has been desperately 
awaiting the release of a quality C++ 
RAD tool, I was interested to hear Al 
Stevens opinions about C++ Builder in 
his “C Programming” column (DD/, May 
1997). Like Al, I've been pretty im- 
pressed, but also like him, I think I re- 
ceived a beta. I find this unfortunate in 
that I was led to believe that I was pur- 
chasing a release version. 

As a data-control ISV, we find the 
namespace problem pretty ugly. Sud- 
denly, several of our most-commonly 
used functions don’t ever get called 
(things like Insert and Update). Even af- 
ter coming up with a workaround, we 
still have to be careful about where we 
place our header files! I think the cutest 
little bug, though (the one that almost 
cost my monitor its already-refurbished 
life), is that if you build a project while 
the code window is minimized, one 
warning or error will completely snafu 
the machine. Apparently, the code win- 
dow gets normal-sized and is put in stay- 
on-top mode when the error or warning 
is found. This is nice for viewing the 
problem, but not so nice for clicking on 


the OK button in the modal Build Project 
dialog. 

I take slight issue with one of Al’s ob- 
jections to the product, however—I real- 
ly like having the VCL components ac- 
cessed by pointers. To me, it feels like I’m 
“really programming.” It’s a psychological 
lift to go from a RAD environment in 
which pointers, like idle time processing, 
are considered the devil’s work, to one in 
which pointers are bandied about like a 
beach ball at an outdoor concert. We’re 
really in C++! Besides, no one I know 
makes pointer errors ;>). BTW, my car 
also has a manual transmission. 

I'll bet Borland catches a lot of heat, 
more so from the fact that it released such 
a promising product with a few bugs and 
poor docs than from just putting out a bad 
tool. Since I’m very excited about this 
product and want to make it one of my 
primary tools, I find the bugs much more 
annoying than bugs in a lesser-used and 
not as cool product. I suspect that I am 
not alone. 

Ken White 

ken@smithware.com 


Dear DDJ, 

Al Stevens’ “C Programming” column 
about Borland C++Builder (DD/J, May 
1997) was great. Perhaps I can add a cou- 
ple points that explain why some things 
in C++Builder operate as they do. 

All the VCL classes have to be treated 
as pointers because the underlying VCL 
(Object Pascal) code is designed that way. 
In Delphi, the decision was made to turn 
all references to classes into pointers. In 
Delphi, it is simply impossible to create a 
class without creating it on the heap. This 
was done for performance- and memory- 
allocation-related reasons, and also be- 
cause it let us simplify notation. Since all 
Delphi classes are allocated on the heap, 
for instance, we could treat them all with 
the same syntax. And since pointer syn- 
tax is confusing, why not let users refer- 
ence those pointers with dot notation, as 
if they were static classes? 

In other words, since all classes had to 
be pointers, we had the luxury of letting 
you act as though they were static refer- 
ences, since the compiler knew it had to 
be a pointer, even if you didn’t use point- 
er notation. Furthermore, most allocations 
and deallocations for these classes are han- 
dled automatically by the VCL. 

Unfortunately, there was no simple way 
to give the same syntax to C++ program- 
mers, since the rules of ANSI C++ wouldn't 
let us change the meaning of pointer syn- 
tax globally, the way we did in Object Pas- 
cal. Of course, allocation and deallocation 
for classes is still usually handled auto- 
matically, as it is in Delphi. However, in 
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Four separate 3D surface charts with contour texturing are 
combined with controls in a CFormView derived class. 


3D with No Program Limits 


Number of data points in a graph - NO LIMITS 
Number of chart objects in a graph - NO LIMITS 
Number of axes in a graph - NO LIMITS 
Number of text objects in a graph - NO LIMITS 
Number of 3D graphs in a view - NO LIMITS 
Number of legends in a view - NO LIMITS 


3D++ and OpenGL 


The 3D graphics engine used by the 3D++ class library is 
OpenGL, the 3D graphics library developed Silicon Graphics, 
Inc. OpenGL is the foundation for many of the most advanced 
3D imaging systems in the world. Originally developed for 
use in the Silicon Graphics line of graphics workstations, 
Microsoft licensed a version of OpenGL for use with Win- 
dows NT and Windows 95. OpenGL is a Microsoft 
*redistributable” and can be included in third party application 
programs without royalties. Many of the newer high-end PC 
graphics boards include hardware accelerators for OpenGL. 
Quinn-Curtis analyzed all of the 3D graphics engines currently 
available for PCs and decided that only OpenGL has the 
horsepower necessary to propel applications into the 21st 
century. 


Ordering Information 


3D++ WIN-M3D-300 $500 


Free Demo Disk and Catalog 
Call, FAX or write for a free catalog and demo disk. Product 


information and demos can also be downloaded from our 
WWW, FIP and BBS sites. 


Order Now! 
Tel. 617/449-6155 FAX 617/449-6109 
30-Day Money-Back Guarantee ! 


WWW http://www.quinn-curtis.com FTP ftp.webcom.com in /pub/quinn/demofiles 





A C++ Class Library for 3D Visualization 
Under Windows NT" and Windows® 95 


The 3D++ ~ class library is written in C++ from the 
ground up using Visual C++'". 3D graphs can be placed in 
any MFC view, occupying the full view or any portion of 
a view. 3D graphs can also be combined with controls in 
dialogs base on CDialog and views based on CFormView. 
The library is implemented as a DLL which adds the 3D 
classes directly to your application program. 


The 3D++ class library is for use with Visual C++ 4.0 and 
higher and MEC. It includes a comprehensive manual 
documenting the 300+ member functions. On-line help 
and 20 example programs are also included. 


3D++ Features 


Axes 

Axes with Tick Marks 
Log axes Waterfall Plot of Vibration Data 
Walls i 

Grids | 
Arbitrary XY Intercepts 
3D Rotated Axis Labels 
String Labels 2 
Manual and Auto-Axes Routines i 
Multiple Axes, Multiple Scalings = 


Chart Objects 


Simple Chart Objects 

Line Ribbon 

Bar Area Fill 
Range Fill Scatter Symbol 
Scatter Text Plane 









Group Chart Objects onl 
Stacked Bar Stacked Ribbon ; 
Stacked Fill Group Bar 


May June July Aug Sept Oct 


Compound Chart Objects 
Open-High-Low-Close 
Box and Whisker 


Commendimode Rejection data at different 
for aff Instruments and environme: 


Polysurface Chart Objects 
3D Polysurface 

2D (Projection) Polysurface 
Contour Lines and Surfaces 


° 

Cnrart Key f 
Min-Max Values ™ ; 
25-50 Percentile @ | 


Miscellaneous 
Lighting 
Legends 
3D TrueType Text 


Serialization 





Quinn-Curtis, Inc. 


35 Highland Circle 
Needham MA 02194 USA 


BBS 617/449-4783 


3D++ is a trademark of Quinn-Curtis, Inc. All other trademarks are the property of their respective manufacturers. 











(continued from page 10) 
BCB, you must use pointer notation when 
referencing VCL classes. 

The keyword __ published refers to 
properties that will appear in the Object 
Inspector. If you publish a property, then 
it will appear in the Object Inspector. 
There was no existing keyword in C++ 
that had the same meaning, so we had to 
make up our own. Somewhat more tech- 
nically, __ published tells the compiler to 
give properties all the RTTI they need to 
appear in the Object Inspector. 

Once again, thanks for your great 
article. 

Charles Calvert 

Borland International 

ccalvert@corp.borland.com 


© 1997 Nematron Corporation. 


Dear DDJ, 

I read Steve Barrett's letter in the May 1997 
DDJ, and would like to offer some infor- 
mation on the subject of the computers 
used in previous NASA missions. I have 
found a good nontechnical book on the 
subject: Computers in Space, Journeys with 
NASA, by James E. Tomayko (Alpha 
Books, 1994, ISBN 1-56761-463-9). 

From this source, the systems that we 
would recognize today as computers 
were all kept on the ground. The sys- 
tems used in the capsules seem to have 
been special-purpose controllers built to 
meet the needs of the spacecraft sensors 
and controls. The Acceptance Checkout 
Equipment (ACE) used two CDC-168s 
while the launch systems used RCA-110As. 


: P teal time for the mainstream 
ghly deterministic performance 


run multiple Windows apps coneutfently 


irq services 


already proven in commercial apps 


FVeiaiv/-),@umeree) natin tiapierialelais 


_ Hyperkernel and Imagination Systems are trademarks, and the Nematron. be é 


Windows NT are registered trademarks and Microsoft Visual C++ a 
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Mission Control (by the time of the Apol- 
lo missions) ran on IBM 360s with a real- 
time modified version of OS/360 called 
RTOS/360. The Fortran code from the 
Gemini days moved from IBM 7094s more 
or less intact. 

The Apollo guidance computer that flew 
in the spacecraft was designed by the In- 
strumentation Laboratory at MIT, appar- 
ently based on work done by Dr. Charles 
Draper for the Polaris missile- guidance 
system. This guidance system ran pre- 
computed programs designed before the 
mission to operate the spacecraft sensors 
and controls. I can’t type in all of the in- 
formation in the book, so let me summa- 
rize it as best as I can. 

The Apollo computer had 50,000 NOR 
gates in integrated circuits for the ALU. 
By the time of the Moon landings, the 
chips were “ancient” technology. The size 
was 2X1 feet by a half-foot. The word 
size was 16 bits, and the machine was a 
fixed-point processor. The memory start- 
ed small, about 4000 words in perma- 
nent storage and 256 words in magnetic 
core memory. By the time of the Moon 
landings, this grew to 36,000 words of 
nonerasable and 2000 words of erasable 
memory. Most of the programs were as- 
sembled by hand in a “core rope:” per- 
manently magnetized rings were lined up 
and the wires of the data bus were “wo- 
ven” through them to record the data pat- 
terns. Magnetic core memory was pre- 
ferred for its invulnerability to radiation 
damage. This hand-woven memory was 
a production nightmare. Secondary stor- 
age memory was a magnetic tape sys- 
tem. Tape recorders are still used in 
spacecraft designs like the Galileo. The 
Lunar lander may have been the pinna- 
cle of Apollo guidance computers with 
the TRW MARCO 4418 (for “MAn Rated 
COmputer”), it weighed “only” 32 pounds 
and required 90 watts of power. 

The book is very interesting, and it lists 
for $20. (1 have no connection to Alpha 
Books or the author.) Anyway, Al Steven’s 
column is my favorite part of Dr. Dobb’s 
Journal and I hope you find this info en- 
tertaining. 

Robert Brauer 

Robert_N_Brauer on CompuServe 


DDJ 


DDJ welcomes your comments and sug- 
gestions. Send letters to DDJ, 411 Borel 
Avenue, Suite 100, San Mateo, CA 94402- 
3522. We can also be reached via edi- 
tors@DDJ.com, 76704.50@compuserve 
.com, and by fax at 415-358-9749. Please 
state your name and address. DDJ re- 
serves the right to edit letters for length 
and content. 
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Develop Java apps 





edit 





compile 





link 





ere: load 


while you’re still young. 





run 





Now thanks to SuperCede’s interactive development environment, it won’t take ages to develop applications. 
Because with our Flash Compiler” technology, you can make changes while your application is running—helping you 
work five times faster. Only SuperCede lets you create high-performance native executables and platform-independent 
applets. And offers seamless C+ +/Java interoperability. Plus with our new editions, you get dozens of Java and 
ActiveX controls and total database support. For the whole story, download SuperCede at www.supercede.com and 


try it free for 15 days. Or call 1-800-448-6543 for your nearest retailer. After all, you’re not getting any younger. ™“ *™~ Serasion 
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ASYMETRIX 800. 448. 26543 | www. supercede. com 


Easy-to-use Internet Tools 
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Paradise No. PSPUA88-FT 


Power++ Pro Comp. Upg. 2.0 
by Sybase/Powersoft 








Paradise No. MSOBW88-FT 


Microsoft Visual J++ 1.1 
Professional Version Upg. 
by Microsoft Corporation 


Decca qeacs Sesen ke Warterax tock tot teuret 





$359." 


Paradise No. MSOCF88-FT 


Microsoft Visual Studio 97 
Professional Version Upg. 
by Microsoft Corporation 


* Price after manufacturer's direct rebate. 


(ad van’ tij) n. superiority, benefit or gain. 


Paradise No. BNNUD88-FT |" 
Borland Delphi 3 Pro Upg. ,.. 
by Borland International __ 


y 93" 
$9." 5 
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WISE Installation 

by Great Lakes 

Business Solutions 

Creates professional installations 
for Windows, Windows NT, and 
Windows 95 all with a single 
installation script. The WISE 
Installation System includes 

both 16- and 32-bit versions of the 
integrated development environment. 
WISE includes all of the standard 
installation features plus: 

custom dialog/graphic editors; 
CD-ROM/Network installations; 
multi-lingual support; and full 


“WISE 


INSTALLATION 
SYSTEM 


Paradise No. 





Windows 95 install requirements. $1 69 
WinDK’ & SoftICE” arene 
Device Driver 
Development 


by BlueWater Systems, Inc. (x 
and NuMega Technologies #& 
The best NT® Device Driver Library 3 
bundled with the best NT te 
debugger. The WinDK Device 
Driver Development Kit is the most 
efficient way to develop high 
speed, high quality device drivers 
for Windows NT and WDM. SoftICE for 
Windows NT is the industry-standard 
debugger. Create bulletproof drivers 
and save yourself weeks of work. 


Paradise No. 
BSWSB88-FT 


$1,069 


Multi-Edit 
with WebLair 


by American Cybernetics 
Now the source editor known 
world-wide for power and 
flexibility includes WebLair’s 
complete Web development 
technology. Supports HTML, 

Java, JavaScript, Perl, and VRML. 
Write JavaScript within an HTML 
file, with full language and syntax 
support for each. Features Editable 
Templates and Common Code 
Management—edits to HTML text 
can be instantly reflected across multiple 
files, and more! 


Paradise No. 
AMWLB31-FT 


$299 


c-tree Plus® 

by Faircom 

DOS ¢ WINDOWS e NT e UNIX @ 
OS/2 © SUN @ RS6000 © HP9000 
MAC @ ONX @ BANYAN e SCO. 
This well known, highly portable data 
management package has become 
established as the tool of choice for 
commercial development. Offering 
unprecedented data control, 
choose from direct low level 
access, ISAM level, or ODBC 
access with the FairCom Server. 
Single User, Multi User, or optional 
Client/Server, ANSI Standard. 

Full Source. No Royalties. 


Paradise No. 
FACTP31-FT 


$785 




















SuccessWare Datal 
Engine Suite 


by SuccessWare 
You're a seasoned professional. 
You've learned the hard way 
that what's free in the box is 
generally worth every penny. You 
demand more from the tools you choose. 
The SuccessWare Database Engine Suite 
offers plug-n-play compatibility, absolutely tiny 
(250k) deployment and rock-solid multi-user access to FoxPro 
& Clipper index and memo files from Microsoft and Borland 
development environments. 
Paradise No. 
SWDES31-FT 


$295 


Ultimate Grid 3.0 paseo 


for MFC 


by Dundas Software 
Includes 100% MFC sourcecode. 
Flexible and efficient design 
integrates with any type of data 
store, including SOL, DAO, ODBC, 
and others. If you develop in 
MEC, drop your ActiveX 
control and let Ultimate 
Grid for MFC save you 
weeks of development 
time. 











Paradise No. 
DSUGA31-FT 


$375 


WinSCSI-32 

by Sequoia Advanced 
Technologies, Inc. 

Full 32-bit SCS! command link library 
with over 150 functions designed to 
make your SCSI application program- 
ming tasks easier. Complete with 
extensive sample source code and 
electronic online documentation, 
WinSCSI-32 is the ideal choice for all 
your SCSI programming needs. For 
Windows 95 and Windows NT. Royalty-free. 


Visit www.pparadise.com for more 
product information! 





Paradise No. 
SEWS288-FT 


$175 


Spread v2.5 

by FarPoint Technologies 
A complete spreadsheet control 
for most environments that 
support a VBX, OLE control, or 
DLL. Use as a spreadsheet to 
obtain variable lines of data or 
display tables of information. 
Data-aware—connect to 
databases with the Access Engine 
and ODBC. Includes over 250 
properties and our improved 
Spread Designer. Formulas, sorting, 
and full-print support too. 





Paradise No. 
FPSOX31-FT 


$229 





Order online 24 hours a day, every day at www.pparadise.com 





Programmer's Paradise’ 


the — definitive source for software! 


WinHelp 


Free book 
\._ with order! 
$19.95 value— 
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Slay those BLOBs 


with DB2°* V2.1! 

by IBM 
DB2 universal database for 
Windows NT® lets you master 
multiple data types better than 
other DBMSs. Can your NT 
database search and retrieve 2 
gigabyte BLOBs based on their 
color, shape or pattern? Can 
your NT database master video, 
audio, images, fingerprints or 
whatever data type you throw 
at it? Can your NT database 
sport the “Designed for Microsoft® BackOffice™” logo? DB2 can. 


DB2 can do a lot more than that, too. Java support, for instance. 
And triggers that let you enforce business rules, validate input 
and even alert users about changes to data. Plus a really slick 
query optimizer that selects the fastest access path to the data. 
And we gave it a multi-threaded architecture to leverage both the 
operating system's and the hardware platform's ability to multi- 
task. Oh, and did we mention that this engine really screams? 
Or that PC Magazine said DB2 was “state-of-the-art” and 
offered “strong performance on almost every front”? —3/26/96. 
No kidding. 

So Web-enable to your heart's content. Get creative. 

Check out the DB2 universal database for Windows NT today. 


Windows and Microsoft are registered trademarks of Microsoft Corporation. 
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Product Name Paradise No. 


IBM DB2 for Win NT 


Single-User 53H7473-FT 
IBM DB2 for Win NT 

Multi-User 53H7474-FT $1 359 
Codewright 
by Premia 


You'll work faster and easier 
when you use the right 
programmer's editor, 
Codewright. Now you'll 
browse code faster with 
Outline Symbols. It gathers 


* bonglands evs | 


Ra eel 


i aa aed 
Beet EL es 


information about your code a 
in the background. You'll juggle changes New 
with ease, with Difference Editing. It lets you Version 
selectively combine the changes from two 5.0! 
revisions. The new Bookmarks Window lets _ .; 
you view bookmarks by name and by file. Now p d 

i é aradise No. 
with synchronizing technology for Delphi and PCCW588-FT 


Visual C++ IDEs. With the help of the API 
Assistant, making complex function calls is 
as simple as filling in a form. Intro price. 


$189 





Office® 4 
by Blue Sky® Software 
“The Complete Help Authoring Solution” 


WinHelp Office 4 includes everything you need to 
quickly and easily produce professional Help systems 
for Windows 3.1, Windows 95, and Windows NT (4.0 
& 3.51), Microsoft HTML Help, Netscape NetHelp, 
printed documentation and intranet/Internet 
Websites—all from a single source! WinHelp Office 
is power-packed with the award-winning RoboHELP, 
Mastering WinHelp, WinHelp Video Kit, 
WinHelp Tool Kit, WinHelp HyperViewer, 
Moving to HTML Help and more! 


WinHelp Office includes RoboHELP. 

















To Order Call 800-445-7899 


BLUE SKY sOfTWape 





RoboHELP WinHelp Office 
Paradise No. Paradise No. 
BSRWD88-FT BSW9788-FT 


$479 $679 


ProEssentials” 

by GigaSoft* 

16- and 32-bit DLL, OCX, VCL, and 
VBX interfaces providing charting 
functionality with consistent 
visual quality, real-world practi- 
cality, and overall professional 
appeal. Suited for engineering, 
financial, data-acquisition, and 
information system development. Be sure to find the best tool 
for your important development needs. Download a demo 
[500K] or get a fully functional evaluation edition [(3Meg] at 
www.pparadise/publishers/gigasoft. 


Paradise No. 
GIPRB31-FT 


$299 





KEDIT for 


Windows 1.5 

by Mansfield 

Software Group 
Includes both 32-bit 
Windows 95/Windows NT U; 

and 16-bit Windows 3.1 for bnolows 
modules. KEDIT is a powerful 

general purpose text editor with 

redefineable keys, undo/redo, selective line editing, regular 
expression support, enhanced syntax coloring, column oriented 
editing, file locking, a macro debugger, an IBM XEDIT- 
compatible command set, prefix area support, 
and more! The macro language Is a subset of 
REXX. Also available in DOS and OS/2 text 
mode versions. 





Paradise No. 
MANKE31-FT 


$139 


List Pro 

by FarPoint Technologies 

A set of customizable List Box and 
Combo Box controls. Create header 
groups and sub header groups 
and/or multiple columns to create 

a very unique list control. Merge 
cells in rows with same text to 

make display more user friendly. 
Bind to supported databases using 
Microsoft Jet Database Engine or 
Microsoft Access ODBC. Virtual 
memory manager allows connection 
to any size database. Supports single 
or multi-select lists, embedded icons 
and bitmaps in columns and rows plus 
drag-and drop capabilities. 


Paradise No. 
FALP131-FT 


$189 















Order online! 
These products and 
< many more are featured at 
NWW.pparadise.com 









Gain the advantage over your 
competition when you take 
advantage of the many opportuni- 
ties presented by the Programmer's 
Paradise catalog! Programmer's 
Paradise features the best prices 
on outstanding development tools 
from today’s top manufacturers. 
Plus, with Programmer's Paradise 
you'll also get exceptional 
service—dguaranteed! 


Check out the products appearing 
on these pages. They're just a small 
sampling of what you'll find in the 
Programmer's Paradise catalog. 


To place your order, call today and 
take advantage of our convenient, 
quick 2-day delivery to any location 
in the continental U.S.! 


A Personal Guarantee! 
“If you're not happy, we're not 
happy! You have my personal 
guarantee that we'll provide 
you with outstanding products, 
Support and service.” 


—Roger Paradis 


President & CEO 
Programmer's Paradise, Inc. 


ORDER NOW 


or call for your free catalog! 


1-800-445-7899 


Call for shipping charges/return policy. 
Prices subject to change without notice. 
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| Speak Up software market, Strategic Focus found www.infonorth. com/). The system offers _ 


_ Whether or not you think speech | is the 


next great user interface, speech-enabled 


- applications are coming. Even the ex- 


__, hibitors at Advanced Speech Applications 

—& Technologies (ASAT) 97 were surprised 
_ by the number of developers moving from 
- booth to booth, looking for the best tools 


= _ to speech- enable applications. 


The highlight of the exposition was 
Dragon Systems’ natural speech recog- 


nition. Traditional speech-recognition 
applications require users to speak dis- _ 


_ cretely, pausing between every word. 
_ Dragon Systems’ latest offering recog- 
- nizes continuous speech, allowing users 
to speak naturally. The system requires 
18 minutes of Bamine and is ies de- 
pendent. 
While Dragon Systems’ new system 
might make dictation more attractive for 
text input than typing, it doesn’t explain 


the rapidly growing interest in speech- 
_ enabling personal computer applications. 


Part of the appeal seemed to stem from the 
use of Microsoft's OS as a development 
platform. Several exhibitors demonstrated 
_ telephony applications using Microsoft’s 
_ TAPI. Others showed how more nontradi- 
tional applications (such as a car diagnos- 
tics program that you could interact with 
while working underneath the vehicle) 
could be written in scoping languages ee 
Visual Basic. 
Mostly, however, developers seemed to 
express interest in speech recognition be- 


Cause it's there. Everyone is buying new 


computers these days that have more than 
the minimum hardware required to run 
_ speech applications, and the plethora of 
offerings exhibited at this conference 
_ showed that speech can be integrated into 
epplicions relatively easily and quickly. 

- eee Eric Kim 


From the “For What It’s 
Worth” Department 


In a recent report, the market-research 
firm Strategic Focus projected the Internet/ 
_ intranet software market will grow from 
$2.6 billion in 1996 to over $7.2 billion 
_ in the year 2001 at a compounded an- 
nual growth rate of 23 percent. Among 
the 15 software market segments ana- 
lyzed, the fastest growing segment was 
web-server software, followed by elec- 
tronic commerce and web-application 
development tools. In the web-server 


that Netscape currently holds the high- 


est market share at 11 percent in 1996 


(measured by the revenue dollars gen- 
erated), followed by Microsoft (8 per- 
cent), Novell (8 percent), and IBM/Lotus 
(7 eee 

— Jonathan Erickson 


Help for the 
Visually Impaired 


Researchers at Texas Instruments have. 
come to the aid of visually impaired com-_ 


puter users by developing a display that 
creates renewable, raised dots on com- 
puter monitors and other screens. Marvin 
Cowens, Alan Gilkes, and Larry Taylor 
have been awarded a patent for the sys- 
tem which can be used to generate 
Braille “characters,” thereby enabling the 
visually impaired to read the display. Cur- 
rent generation Braille displays rely on ex- 
pensive and cumbersome mechanical pegs 
and moving parts. 

According to the patent, the TI inven- 
tion “consists of a matrix of small cavities, 
each containing a positive and negative 
electrode, and filled with...polar organic 
gel responsive to electric fields.” An elas- 
tomeric film is then stretched over the ma- 
trix and voltage is applied to individual 


cavities, causing the gel to expand and 


create a raised dot on the film. The dots 
are the standard Braille size of 1.5 milli- 
meters, but can be adjusted. 

— Jonathan Erickson 


Yet Apothes 
Intel /AMD Spat Settled 


Intel and AMD have announced they’ve 
settled yet another trademark dispute, this 
time over AMD’s use of the “MMX” tag in 
marketing its AMD-K6 chip. Intel claimed 
that MMX is a brand name, describing 


Intel-developed graphics, audio, video, ~ 


and communications technology. Under 


terms of the agreement, AMD can use the. 


term, but must acknowledge Intel’s own- 
ership of the trademark. 
— Jonathan Erickson 


One-Touch Divorce | 


California's Sacramento County Courthouse 
is the latest legal venue to install Quick- 


Court, an interactive information kiosk 


made by North Communications (http:// 


court information in English or Spanish © 


and, with the touch of a button, can pro- 


duce forms for users filing on family law . 
matters — such as dissolving or nullify- 
ing a marriage— or small claims. Com- 
parable systems are already in operation = 
in Arizona and Utah. In addition to 
QuickCourt, North Communications pro- 
duces other touch-screen systems for aid- _. 
ing the public in dealing with the long 


arm of the law, such as the AutoTouch 


driver-testing system, a Traffic School — | 


alternative for some Los Angeles Coun- 
ty traffic violators, and AutoClerk, an 


ATM-like kiosk that accepts payments for 


traffic citations. 


Silicon Valley civil Suit 
Gets Criminal 


What was a civil battle between California- 
based Avant! and Cadence Design Sys- __ 
.tems recently moved into the criminal 


arena, when the Santa Clara County Dis- 
trict Attorney’s Office filed felony charges 


of conspiracy and theft of trade secrets 
against several Avant! executives. T he 


two companies have been sparring in | 


civil courts since 1991, when several Ca _ 
dence employees left the company to 
form Avant! Corp. Both companies pro- 
duce chip-design software. The D.A. 
claims criminal charges are the result of 
an investigation by its High Technology 
Crimes Unit, which has reportedly found _ 
evidence hat the defendants used stolen | 
Cadence technology to develop com- 
peting products. Interestingly, in regard 
to the civil suit, Avant! claims that the —_ 
USS. District Court issued a ruling favor- 





able to Avant! in March. Ihe federal 


_ judge in that case found no use of mis- _ 


appropriated code in Avant!’s wares and — 


rejected Cadence’s motion to enjoin the 


sale and support of Avant!’s products. | 


Avant! President Gerald Hsu denies all _ oS 
charges and stated that he “believels] that 


the D.A.’s office has been misled and 
misinformed by other parties in this mat- 






ter.” For Cadence’s part, company pres- 
ident Joe Costello stated, Cadence [ie —CC 
victim of these charged crimes, is pleased 
that the D.A. has decided to prosecute —_—© 
Avant!,” adding that Cadence intends to —© 
continue pursuing the civil action against  . 


Avant!, as well. oo 
ae Dei rdre Blake 
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Implicit Surfaces and 
Real-Time Graphics 





Introducing the Silly Space 
modeling application 





Kyle Lussier 


mplicit surfaces are generally defined by an equation model 

that provides a logical basis for creating a closed surface in 

space. Implicit surfaces are useful in that they can be used 
in areas such as molecular modeling, animation, geophysical 
systems, and weather analysis. 

Implicit surfaces are at the heart of Silly Space, the modeling 
application I'll describe in this article. Silly Space (available at 
http://www.inside.ch/silicon_softworks/ or http://inside.net/sil- 
icon_softworks/) lets you manipulate implicit surfaces in a real- 
time, click-and-drag 3-D environment under Windows 95/NT. 
Silly Space works by integrating an equation model, 3-D user 
interface, and surface tessellator into one working body. These 
components fit tightly together to provide an easy-to-use, ro- 
bust modeling application. 

Figure 1 is a function that describes the implicit surface of 
a two-component blob (or “meta-ball,” as it is more com- 
monly referred to). Figure 2 is the two-component blob mod- 
eled in Silly Space. By plugging in arbitrary values for x, y, 
and z in Figure 1, you can test where the function changes 
sign. It is at this point that a surface needs to be determined 
for visualization. 

Of course, there are numerous methods for building a visu- 
alization of this surface. In raytracing, an exact evaluation of the 
surface is done for a displayed pixel. The surface can also be 
decomposed with voxels (volume pixels) to show the variations 


Kyle is a member of the Advanced Technologies Group at Ad- 
vanced Visual Systems in Boston. He is also the author of POWER- 
3D: High-Speed 3D Graphics in Windows 95/NT (Manning/ 
Prentice-Hall, 1997, ISBN 0-13-841214-6). He can be contact- 
ed at lussier@inside. net. 
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in density of the space given by the equation. In Silly Space, I 
decompose the surface into a set of triangles using a polygon 
tessellator. 


Multi-Geometry Surface Model 
Implicit surfaces can be generated in many different ways, the 
most common being to design an equation that models the de- 
sired surface, then visualize or model it. However, this is cum- 
bersome, time-consuming, and error-prone. In the interest of 
simplicity and flexibility, | used a multi- geometry surface mod- 
el (MGSM)— a component-based implicit surface model. Figure 
3 presents the general form of the MGSM model. 

The goal of this model is to allow interactive user selection 
of various components and shapes and to connect this with the 
user interface. The quantities in the model are: 


e Threshold, which specifies how tight the surface is in relation 
to the components of the model. 

e shape(x,y,z), Which provides the individual shape of a par- 
ticular component. In Figure 2, I used two sphere-shaped 
components. 

© space(x,y,z), which provides for spatial effects — rotation, scal- 
ing, stretching, and so on—for each component. 


The MGSM model is implemented in Silly Space by taking 
each of these quantities and tying them together in a fast C++ 
implementation (see Listing One; listing begins on page 81). The 
exact model for the MGSM is given in Figures 4(a), 4(b), and 
4(c). The first step is to perform the preliminary rotation of an 
individual component in the field. For instance, if you have a 
normal sphere component and a sphere component that has 
been stretched in two directions into a disc-shaped object, you 
could rotate the disc freely in any number of directions. This 
rotation is specific to the component only, and all other com- 
ponents will stay fixed in space. 

Figure 4(a) shows the equation form for the rotation that is 
the first step in the MGSM. Figure 4(a) is part of the space(x,y,z) 
transformation. The rotation equation takes the three angles, rel- 
ative to the x-, y-, and z-axes, as well as the parameters given 
as arguments to the MGSM call, i(x,y,z). 

Now that we have performed the rotation of the given test- 
ing point with the equation in Figure 4(a), the next step is to 
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add stretching and translation to the individual component. This 
transformation is also still part of the space(x,y,z) aspect of 
the MGSM. 

The last modeling aspect of the MGSM is to apply the shape 
of the current component. Figure 4(c) is one example compo- 
nent. The shape given is the implicit equation of a sphere (meta- 
ball). The evaluation of this quantity is for a single component 
in the entire surface. The corresponding summation of many of 
these components is what makes a complete, artistic surface in 
Silly Space. 


Decomposing MGSM into Triangles 

Silly Space makes use of Jules Bloomenthal’s implicit surface 
tessellator, which was presented in Graphics Gems IV, edited 
by Paul Heckbert (Academic Press, 1994). The tessellator works 
by accepting a function similar to the MGSM and searching the 
space to find the edge of the surface. 

Bloomenthal’s tessellator moves around on the surface of a 
geometric definition and creates a triangle-based tessellation of 
the model. It does this by using a collection of cubes to walk 
around on the surface. Each cube is used to isolate the surface 
along the boundaries of the cube (see Figure 5). The resultant 
testing of the 8 vertex locations on the cube gives 28=256 pos- 
sible test cases. These test cases are either positive (inside the 
surface) or negative (outside the surface). The test cases are 
mapped to bits and used in a look-up table to determine which 
edges need to be searched for the surface. After calculating all 
of these edge/surface intersection points, the algorithm then 
spits out the representative triangle set for that cube. The cube 
is then moved to the next point on the surface. 

Silly Space uses a hybrid version of Bloomenthal’s original 
tessellator. Some specific additions and modifications to it for 
real-time interactive use include: 


Initial surface detection. The original tessellator used a ran- 
dom space searching method to find the starting edge of a surface. 
Silly Space computes the exact starting point of a surface and be- 
gins tessellation at this point. This turns out to be much faster than 
the random searching method if you already know where to start. 










Figure 1: Function that describes the implicit surface of a 
two-component blob. 


Silly Space - Silly Space File 1 
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Object orientation. The tessellator was broken down into a 
modular object-oriented form in C++. This new modular form 
was ideal for finding optimization points, and code enhance- 
ments gave an overall performance increase. 

Disjoint surface detection. The original tessellator did not 
find disjoint surfaces, or surfaces that were not attached to 
the currently tessellated surface. Silly Space’s implementation 
detects and tessellates these disjoint surfaces in a nearly lin- 
ear manner. 

Improved memory model. The original memory allocation 
model was not well suited to repetitive real-time calls to the 
tessellator. The memory model was replaced with an allocation 
model that prevents memory leakage and speeds up overall 
memory allocation and destruction. 


Component Shapes 
Any given surface or set of disjoint surfaces is made up of a col- 
lection of components. These components can take many dif- 
ferent shapes. In Figure 2, for instance, the two components 
were in the shape of spheres. 

Other forms are possible, such as a cube, or even a toroidal- 
shaped component; see Figure 6. There are no real limits to the 








Figure 3: MGSM general form. 


Figure 4: (a) Rotation component of space(x,y,z) in 
MGSM,; (b) Translation and Stretching component of 
space(x,y,z) in MGSM; (c) implicit sphere equation in 
shape component of MGSM. 
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Figure 5: Isolating the surface along the boundaries of 
the cube. 


variety of individual field-based components in Silly Space. The 
trick is finding the ones that are computationally quick to eval- 
uate and are actually useful as primitive modeling components. 


Spatial Transformations on Components 

Another significant part of the MGSM is the idea of applying 
various spatial effects to any given component shape. Spatial- 
transformation effects are applied to part of the model. All tra- 
ditional spatial transformations fit well into this model. 

For instance, scaling along the x-,y-,z-axes can be done by 
modifying the spatial-transformation part of the model so that 
it scales the individual component along each axis. This could 
be done, for instance, by multiplying the testing point by, say, 
0.6 to shrink the model on the x-axis by 40 percent. Figure 7 
shows five individual components— one a perfect sphere, the 
others stretched into the forms of disks. Each disk is created by 
taking the perfect sphere and stretching it along two separate 
axes. Additionally, each disk is rotated about different axes. The 
wireframe camera view on the right has lines indicating the cen- 
ters of each component. 

Components can also be created that subtract space from a 
surface. For instance, consider using a number of components 
in the traditional sense (each component adds to the model). If 
you take a single component that is among a collection of pos- 
itive or additive space and invert the field, the component will 
subtract from the space of the model. 

On the front cover of this issue, for instance, the penguin’s 
nostrils use negative or inverse space to subtract from the main 
figure. Mixing and matching both positive and negative space 
provides a powerful way of shaping and molding the space. 
This combined with different component shapes and the trans- 
formations you can apply to these shapes gives the user a flex- 
ible, easy to use modeling application. 


Texturing Implicit Surfaces in Real Time 

Silly Space also provides a real-time texturing capability for im- 
plicit surfaces. In Figure 8, the human hand was created in about 
15 minutes by stretching and shaping each finger and attaching 
them to a base disc. A texture that resembles skin is then at- 
tached to the surface. Note the top-right camera view. This view 
is inside of the hand looking down the finger spaces. The lines 
are the component fields that make up the hand. The texturing 
is done by importing and attaching a Windows bitmap (BMP), 
a device-independent bitmap (DIB), or a run-length encoded 
bitmap (RLE). Because the image file is converted to one of 
these formats, any image can be used. 
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Silly Space implements a couple of optimizations to speed 
texturing of the surfaces. The first step is to reduce the giv- 
en texture to a power of two and scale it into a square. Com- 
puters can multiply and divide by a power of two very quick- 
ly. The multiplication or division by two operations boil 
down to a shifting of bits, as opposed to a multiplication 
call. For instance, the number three is 11 in binary, and the 
number six is 110. By shifting the bits left one, the number 
is doubled. This aids the scaling process as the bitmap size 
can be scaled to a good texturing size very quickly. The 
closer the size of the available texture to the one being 
drawn, the better the texture mapping. Silly Space also con- 
verts the bitmaps palette to a true color 24-bit palette. Fig- 
ure 9 shows the complete hand with the texture color blend- 
ed with the base color of the implicit surface, which is in 
this case a light orange. 


The Silly Space API 

Silly Space uses the traditional MFC document/view model; see 
Figure 10. Silly Space provides derived classes from the base 
CView and CDocument classes. These derived classes are called 
CSillyView and CSillyDocument, respectively. 
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Cross-Platform 
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FaxMan provides Windows Developers with a Plug- 
In programmable fax engine which instantly allows 


applications to send and receive faxes using 
standard off the shelf fax modems. 


The FaxMan SDK includes 16 & 32 bit DLLs and 
ActiveX controls as well as Windows 95 and NT 


printer drivers for creating fax output. And because 


FaxMan was designed for programmers, not end- 
users, you provide the user interface so your users 
won't even know you're using it. 


Visit our website and download the complete 
FaxMan documentation and you'll see how 
FaxMan can simplify your development. 
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or call 
800-955-8015 





300 Pensacola Road ¢ Burnsville, NC 28714 
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(continued from page 20) 

The Silly Space document object, CSillyDocument, contains 
all of the data necessary to build the live model. This includes 
the surfaces, spaces, shapes, and tessellations of the model. It 
also includes the necessary streaming code for writing the mod- 
els and surface bitmaps to disk. The object handles all of the 
following details: 


e Streaming of objects to a CArchive object for persistent (on 
disk) storage. 

¢ Collections of components with the associated parameters for 
computing the geometry surface of a model. 

e The shapes (sphere, disk, and so on) of user-created com- 
ponents in the model. 

e The spatial transformations (scaling, translation, and the like) 
of user-created components. 


Silly Space makes use of 
Jules Bloomenthal’s implicit 
surface tessellator 





The Silly Space view object, CSillyView, provides the im- 
plementation details of the 3-D user interface. It also handles 
construction and setup of the OpenGL rendering context, or 
the HRC. Command handlers provide control and manipula- 
tion of the modeling surfaces. For instance, you click on one 
button to increase the detail level of the surface tessellation. 
This changes the necessary geometry and CSillyDocument pa- 
rameters and recomputes the tessellation. CSillyView is re- 
sponsible for: 


e 3-D click-and-drag UI, which is what makes Silly Space so 
easy. It makes use of Geometry Object Extensions (GOEs) to 
handle the intersection and interactive manipulation of com- 
ponents in the space. 

e¢ Command handlers, which provide input and capability be- 
yond the 3-D click-and-drag UI. Command handlers for the 
view change the current tool (from a node select tool to a 
hand tool, for instance). 

e Camera view parameters. Individual views have different cam- 
era viewing parameters. Each view can be a different camera 
angle on the model. 

e OpenGL initialization. CSillyView also provides complete ini- 
tialization and setup of OpenGL for proper use in Silly Space. 


Geometry Object Extensions 

OpenGL provides a framework for fast and accurate graph- 
ics, but it does not do everything that is necessary to make 
Silly Space work. The biggest deficit is the lack of an inter- 
nal method for holding and maintaining data containers and 
data structures for building models. This is not really a down- 
side of OpenGL, however, as every graphics application will 
need a different form of container. Silly Space requires the 
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Figure 8: A hand with a texture attached to the surface. 


ability to collect data and then provide user interface queries, 
creation and deletion of members, fast pipelining of data into 
OpenGL, and so on. To provide these abilities, I created Ge- 
ometry Object Extensions (GOEs) to the OpenGL framework. 
GOE objects are what make Silly Space easy to use. They 
provide an abstract layer of communication between the sur- 
face tessellator, the object database (CSillyDocument), 
OpenGL, and the user. The objects I created include: 


e LObj, a derived object from the MFC CObject. This object spec- 
ifies proper virtual methods for drawing an object and for per- 
sistently storing the object. 

e /Vector, the fundamental 3-D math geometry object. This ob- 
ject provides normalization, magnitude, scaling, skewing, and 
other members for handling 3-D space. 

e /Plane, the plane object that handles all of the intersection 
and collision functionality. This object is the fundamental unit 
for the 3-D UL. 

e LCube, a cube object that can be drawn, and is used in in- 





Figure 9: Texture color blended with the base color of the 
implicit surface. 
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Figure 10: Silly Space’s implementation of the MFC 
document/view model. 


tersection calculations with the mouse. The cube object uses 
a set of six LPlane objects for intersection testing. 

e (Sphere, which can be drawn like the others and provides 
a ray-to-sphere intersection capability. Stretched spheres 
are used for intersection of the implicit surfaces in Silly 
Space. 

e (Triangles, which provides organization of vertex- indexed tri- 
angles and handles the drawing and modeling of collections 
of triangles in an API optimized manner. For instance, this ob- 
ject uses the shared vertex lists feature (when possible) that 
is new in OpenGL 1.1. 

e Surface, which encapsulates the implicit surface tessellator, 
intersection calculations for the user interface, different draw- 
ing modes, texturing, and the overall behavior of surfaces in 
Silly Space. 


Spline Paths for Components 

Suppose you want to move the components of the field around 
in space. You know those movies they make with lumps of 
clay? They move the clay and then take a picture, and then 
more the clay again, and so on. Eventually they have a com- 
plete movie. This process is slow and cumbersome. 

Silly Space lets you design the complete model, and then 
key-frame motion in the model. You can, for instance, cre- 
ate three separate states for the model. Silly Space then takes 
the user parameters of the quantity and fits spline curves 
through these parameters. The result is an infinitely smooth 
animation of the components, even though the user only spec- 
ified three frames. 


DDJ 
(Listing begins on page 81.) 
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A Memory-Constrained 
Image-Processing 








Patterns for 
processing pictures 





Mayur Patel 


mage-processing applications are hun- 

ery for both processing time and mem- 

ory. CPU demand typically does not 

pose a problem, since most operating 
systems’ schedulers can adequately bal- 
ance the needs of competing applications. 
However, virtual memory is the only ser- 
vice provided by the operating system to 
deal with the memory load. Allowing an 
image-processing application to swap 
memory pages to disk impairs all the ac- 
tivity on the machine. 

A good image-processing library 
should deal with this memory problem 
with minimal supervision from you. In 
this article, I present an image-processing 
architecture that gives you a reasonable 
degree of control over memory con- 
sumption. 


Tile On Demand 

Tile-based processing consists of divid- 
ing an image into small, rectangular pieces 
called “tiles,” processing each tile, and re- 


Mayur is a member of the software de- 
velopment staff at Cinesite Digital Film 
Center, a full-service post-production and 
visual effects facility. He can be contact- 
ed at mpatel@cinesite.com. 
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assembling the image. The principle of 
locality applies, so an image-processing 
operation usually requires input tiles of 
approximately the same area as the out- 
put tile. Clearly, processing each tile re- 
quires less memory than processing the 
entire image. 

Many existing image-processing libraries 
support scan-line-based rather than tile- 
based image processing. Scan-line libraries 





are easy to implement and often perform 
efficiently because most image file formats 
store data in scan-line chunks. However, a 
tile-based approach retains the same ad- 
vantages (scan-lines are simply tiles with a 
height of one pixel) and is more general. 
One case where you benefit directly 
from flexible tile size is with transform- 
based image compression. Many popular 
Discrete Cosine Transform-based com- 
pression algorithms require 8x8 tiles. With 


Architecture 


scan-line-based libraries, you must con- 
struct 8x8 units by writing eight scan lines 
into a buffer and moving data back and 
forth from the buffer accordingly. This is 
unnecessary busy work; it is better to pro- 
vide tiles in whatever proportions you re- 
quest. 

Another convenient feature is lazy eval- 
uation. Processing on demand reduces the 
expense of image processing and pro- 
motes interactivity. For example, users 
may reorder the sequence of operations 
several times before explicitly requesting 
an output image. Users may also require 
only a small portion of the output image 
or may extract data somewhere in the mid- 
dle of the pipeline. Such requests can be 
serviced in less time than it takes to pro- 
duce the entire output. Demand- driven 
processing helps to minimize wasted com- 
putation in these situations. 

In this framework, data requests prop- 
agate from the output toward the input 
(see Figure 1). The input satisfies those 
requests and triggers the appropriate com- 
putation, and the result flows back toward 
the output. Along the way, operations are 
applied to the data according to the de- 
pendency information already supplied 
through the application. By the time the 
data reaches the output, all the specified 
operations have been performed. 

Coupling demand-driven execution with 
tile-based processing yields an environ- 
ment with great potential. Certainly, these 
features carry with them nontrivial over- 
head. However, they also work together 
to reduce the total amount of memory re- 
quired to process images. The extra cook- 
ing time is often worth the wait. 
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Better Productivity Tools! 


TE Developer's Kit 
Rich Text Edit Control 





This advanced Rich Text 
control features wysiwyg multiple fonts 
and colors; paragraph indentation, justifica- 
tion, spacing, tabs, border and shading; RTF 
import/export, embed pictures, controls, and 
OLE objects, read-only mode and printing. 
Advanced features: Pagination, columns, 
sections, hyperlink support, hidden and 
protected text, tables, page header/footer, 
text/picture frames, line/boxes, print preview 
with zoom. Includes DLL, VBX, OCX, and 
MFC interface. Also includes the complete 'C’ 
source code. (Windows or WIN32: $389). 


Call for DOS & OS2 versions and an HTML 
viewer/editor control add-on ($299) 


ReportEase Plus 


ReportEase Plus consists of a report 
layout editor and a report executer. Advanced 
features include: multiple files, multiple sorts; 
data, calculation, system, and dialog fields; 
bold, underline, italic formats; subtotals, 
record filter, functions, word wrapping and 
more. This DLL/VBX features a graphic form 
editor with line/box drawing, colors/ 
shades, drag/drop, print preview, etc. 
Includes the ‘C’ source code. (Windows or 
WIN32: $459) 


Form Plus consists a form designer 
and a form executer. The product supports 
line/box drawing, fonts, colors/shades, 
drag/drop, check box, radio button, 
push button, images, print preview, 
etc. (Windows or WIN32: $399). 


Spell Time 


Spell Time consists of a dictionary 
(over 100K words) and the routines to access 
the dictionary. It also includes an application 
specific dictionary, and a user dictionary. The 
routine will suggest alternatives for a 
misspelled word. Highly optimized: 400 to 
500 words/sec on a 33 Mhz 386 computer. 
Includes the ‘C’ source code. Specify DOS, 
Windows, WIN32 or 0S2-PM. ($389) 


Other Products 
ChartPro: This DLL draws bar, pie, 
line, area, xyz point chart ($399). Rich 
Text Grid: This grid control supports 


multifont and multiline text within each 
grid cell ($399). 


Sub Systems, Inc. 800-447-6819 
Fax: 508-352-9019 








Demos available: www.subsystems.com 


11 Tiger Row, Georgetown, MA 01833, 508-352-9020 
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(continued from page 24) 
Object Interaction 
This tile-based image-processing archi- 
tecture is inherently object oriented. The 
interaction between three fundamental 
classes —Image, ImageTile, and Image- 
Man— is the foundation of the system. 
Tiles constitute the interface between 
the library and the application. You need 
not be aware of the internal representa- 
tion of the image as long as the tile im- 
plementation is sufficiently general to han- 
dle the widest range of cases. 
Applications request pixels in two ways. 
The more convenient interface is /mage:: 
newTile(), which allocates a new tile and 
fills it with image data. The other interface 
is Image:.fillTile(), which accepts an exist- 
ing tile for processing and overwrites its 
contents. The API is as simple as that. 
Behind the scenes, the image interacts 
with the image manager; see Figure 2. /m- 
age.:newTile() requests (which go to the 
image manager) let the image manager pro- 
vide a host of services, including caching. 











“Library Client image 








_ newTie() 





_ newTile() 
__ Returns tile pointer 








Do work until 
tile is no  -. 
longerrequired | 


Figure 2: Object interaction. 


Figure 1: Tile-based, demand- driven processing. 
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‘Returns okay 


newTile( ) 
sturns tile pointer 


Re 
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The manager eventually comes back to the 
image and uses its Image..fillTile() method 
to compute data. 

In the obvious implementation of this 
interaction pattern, there is one ineffi- 
ciency. When the system receives a 
newTile() request, it immediately allocates 
memory. Jmage:.fillTile() then pulls input 
data into scope for local processing. The 
fillTile() method most likely uses the 
newTile() interface to request data, so 
memory is allocated at every step as re- 
quests propagate backward. These allo- 
cations aren’t actually needed until the 
data begins to flow forward. 

A more constrained approach allocates 
memory only after the input data is avail- 
able, but I prefer the former behavior for 
two reasons: 


e It supports a flexible interface between 
the image and image manager. 

e It supports a simple developer interface 

for the implementation of real image 

processing operators. 









C 


Image Manager : 









new 


fillTile() 











fillTile() 


Dr. Dobb’s Journal, July 1997 


Implementation 

The tiles in my architecture use the 
(X,Y,Z,C) image-space model. The X 
component represents the width, Y rep- 
resents the height, C represents the col- 
or channel, and Z the frame number. This 
model lets you describe images of any 
number of channels. It also lets you de- 
scribe a series of images as a sequence, 
which is useful for processing digital 
video or film since an animation is ex- 
pected to consist of several frames, each 
with a uniform width, height, and chan- 
nel count. 

The coordinate (x,y,z,c) is sufficient to 
specify the smallest datum. In addition to 
these coordinates, my tile structure (see 
Figure 3) contains width and height ele- 
ments that make it possible to represent 
a one-channel area from an image. You 
can access pixel data using methods pro- 
vided by the tile class. 

Different applications will require pix- 
els of different precision. For example, 8 
bits per color channel commonly repre- 
sents image data. For higher quality work, 
however, 16 bits per channel is more use- 
ful. In some cases, particularly in scientif- 
ic computing, 32-bit floating-point values 
(0.0 to 1.0) best represent each plane. This 
implementation supports all three options. 
A method allows typecasting the data be- 
tween supported types. 

Granted, using macros in C++ is gen- 
erally bad programming style. Likewise, 
cute macro tricks in C also represent 
poor programming style. However, I have 
used both to encapsulate data-type sup- 
port. Any technique, with disciplined ex- 
ecution, has its place. In this situation, 
a new data type may be incorporated 
with the addition of only one function. 
No changes to existing code are neces- 
sary. You can judge the case for your- 
self. This approach is discussed in more 
detail in the accompanying text box en- 
titled, “A Macro Technique for Manag- 
ing Types.” 

The tile class inherits the properties of 
a referenced object. Smart pointers may 
be used to organize tiles at the applica- 
tion level. The method Tile::deleteTile() 
is included to complement the /mage:: 
newTile() method. Image::newTile() pro- 
vides construction services; Tile::delete- 
Tile() provides dereferencing and de- 
struction services. 

My image manager implementation is 
generic, providing the minimum set of 
services required to meet its obligations. 
At most, only one image manager may 
exist at any time. An auxiliary class regu- 
lates access. The Singleton design pattern 
applies well to the image manager, mak- 
ing sure only one instance of a class ex- 
ists at any time. Blending the referenced- 
object pattern with the Singleton pattern 
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also ensures that the image manager is 
deallocated when it is not required. This 
is useful if image processing represents 
only a small portion of the total applica- 
tion. Attaching an image-manager refer- 
ence to images through the base class en- 
sures that the image manager is 
instantiated during the lifetime of any of 
its potential clients. 

I provide two base classes for images: 
Inputlmage and SamplediImage. InputIm- 
age best suits images (described as math- 
ematical functions) that may have variable 
resolution or unlimited range. Sampled- 
Image best suits images of finite resolu- 
tion and range. 

SampledImage uses the Strategy design 
pattern to deal with out-of-range behav- 
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#include <iostream. 
class X; 


void eradicate ( X * p ) 
{ delete p; } 

class X { public: virtual 
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public X { public: int ay; 
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ior. The Strategy design pattern encapsu- 
lates implementations of an algorithm so 
that the algorithm isn’t hardwired into a 
class. A SampledImage may receive a re- 
quest during a convolution calculation for 
data beyond its range of valid samples. 
Fill-strategy objects may be attached to 
Sampledimage to determine how this area 
is validated before the tile is returned to 
the client. 

I don’t use a base class for the output 
image. Since the output can flow to the 
screen or printer as easily as to a file, the 
output mechanism will often depend upon 
application-specific code. Additionally, the 
demand-driven characteristic of the ar- 
chitecture makes it easy not to place con- 
straints on the output. 
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Figure 3: The (X, Y,C,Z) image-space 
model. 


Example Applications 
Listing One (listings begin on page 81) is 
a test program that enhances the contrast 
of an SGI RGB file. The program first spec- 
ifies data dependencies using class con- 
structors. The first object opens an SGI 
RGB-format file. The second object exe- 
cutes the contrast-enhancement operation. 
The last object writes the data to an out- 
put file, possibly converting the data type. 
Once these dependencies are defined, in- 
stantiating the output image triggers pro- 
cessing of this simple chain. 

SGI RGB files are both powerful and 
flexible, supporting 8- or 16-bit integer 






ff presented here, I use a macro tech- 

nique to encapsulate data type sup- 

_ port. Like any macro technique, it re- 
quires disciplined use. However, it 
provides a convenient way to make 
branching decisions based on 1 type in- 
formation. 

_ C/C++ programmers are familiar with 
the source-header file combination. To 
implement this macro technique, I need 
another kind of file. I call this a macro 
file, and I use a “.m” extension. Some 
choose to call it an include file, with a 

_ “i” extension. 

__ There are three things to notice in List- 

| ing Four, which is an example macro 


n the image-processing architecture 


| undefined by the end of the file. Sec- 
_ ond, the macro TYPEMACRO is not de- 
fined within this file, even though it is 
used. TYPESEPER and TYPEENDOFLIST 
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| file I call “Type.m.” First, all macros are 


channels and any number of color chan- 
nels. As you can see from the Contraster 
class (see Listings Two and Three), im- 
plementing new operators is straight- 
forward. Contraster consists of a con- 
structor, a destructor, and a fillTile() 
implementation. Developers of new 
image-processing operators are well 
shielded from the image manager and 
other system complexities. 

The Contraster object executes the 
contrast-enhancement operation using 
floating-point math. I did this for two rea- 
sons. First, it demonstrates how easy it 
is to typecast the data in tiles. (But be 
warned: Typecasting is as expensive as 
any pixel-processing operation.) Second, 
using floating-point math makes it easy 
to deal with over- and under-exposure 
problems. Integer values may overflow 
or underflow, whereas floating-point val- 
ues retain data integrity. There are ways 
around integer saturation, but I show 
floating-point in action for the sake of 
example. 


Extending the Library 

Since my image-manager implementation 
doesn’t take full advantage of the flexi- 
bility of the architecture, it is a good place 
to start extending my implementation. 
One of the first features that should be 
incorporated into the image manager is 
a tile-caching mechanism. Imagine a chain 
of convolution operations executed us- 
ing the current implementation. As the re- 
quests for tiles propagate toward the in- 
put, the size of the requested area 


A Macro Technique for Managing Types 


are defined only if they haven’t already 
been instantiated. Third, one of the el- 
ements in the TYPEMACRO is a formal 
data type. 

The parameters to the TYPEMACRO 
calls encapsulate a table of information. 
Depending on your application, you 
will need different information in this 
table. The trick is to keep this table min- 
imal. In the image-processing architec- 
ture, I had to include function names, 
numeric values, and precedence infor- 
mation. 

Listing Five shows one way you can 
use the macro file in Listing Four. This 
bit of code declares an enumeration that 
can be used to identify and manage types 
in a cleaner way in other parts of the 
code. The TYPEMACRO definition allows 
information to be extracted from the table 
in the Type.m file and used in the cur- 
rent context. The TYPESEPER and TYPE- 








becomes larger. Over time, these requests 
will result in excessively redundant cal- 
culations. 

A cache minimizes redundancy by stor- 
ing data that is perceived to be frequent- 
ly used. Although the cache requires more 
RAM— one of the constraints you’re try- 
ing to overcome— you can control how 
much RAM it uses. Giving some RAM back 
to the processing engine for caching is a 
guard against extremes in the space-time 
tradeoff. Remember, caching operator data 
saves more than the computation at that 
node in the pipeline. It saves computa- 
tions at every node up to and including 
that operation. 

How you implement the caching 
mechanism depends on the execution 
characteristics that you want the library 
to have. You can cache individual tiles, 
color channels, or entire images. You may 
need predictive caching or reactive 
caching. Matching your needs with a 
cache implementation is well worth the 
development time. 

Earlier, I described why I have two im- 
age base classes. The Inputimage encap- 
sulates infinite-range or infinite-resolution 
data. The Sampledimage encapsulates tra- 
ditional image representations. If the 
caching technique you prefer depends on 
tne image’s resolution or range, you will 
not be able to cache Inputimage images. 
If so, then you may add /nputimage sup- 
port by making /nputIlmage’s newTile() 
method defer to the image manager. This 
gives you more flexibility in experiment- 
ing with new caches. 





ENDOFLIST elements allow the includ- 
ed table entries to adapt to the syntax of 
their context. Listing Six illustrates an-_ 
other way to use the macro file in List- 
ing Four. 

The application uses the io 
type declared earlier to provide type in- 
formation when the function is invoked. 
In this case, data is available through 
void pointers, but in general, any inter- 
face that supports easy typecasting will 
work. The macro definition and include — 
statement fill the switch with a variety 
of alternative behaviors, depending a 
the specified type. 

I originally learned this technique 
while implementing databases, but it 
clearly can be applied to a wide variety 
of situations. With sparing, disciplined 
use, it can be a powerful tool for man- 
aging types in C/C++. 
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Once you have implemented a cache, 
it would be nice to offer forced caching. 
Some image operators, such as a Fast 
Fourier Transform (FFT), are not localized. 
To execute an FFT, it is easiest to process 
the entire image at once. And it isn’t 
cheap. Forced caching lets you identify 
and address hot spots for the caching sys- 
tem, such as these nonlocalized operators. 
Without forced caching, or if there isn’t 
enough room to cache the entire FFT im- 
age, each tile request arriving at the FFT 
image will likely result in recalculation of 
the entire image. 

Another characteristic of the current im- 
age manager is that tile sizes are not reg- 
ulated. Currently, the application is on its 
honor not to request more data than it ac- 
tually needs at one time. Poorly designed 
applications may request the entire image 
in one call. The current image manager 
will propagate this request. This defeats 
the purpose of having an architecture de- 
signed to constrain memory demand. 

Request decomposition allows the im- 
age manager to decompose requests for 
large tiles into several requests for small- 
er tiles. Processing each smaller tile re- 
quires less memory than the whole. An- 
other benefit of request decomposition is 
that the requests for the many small tiles 
may be executed in parallel. Giving the 
image manager the power to dispatch con- 
current requests empowers the entire sys- 
tem with concurrent execution behavior. 
The developer of image-processing oper- 
ators doesn’t need to worry about writing 
parallel code. 


Conclusion 

The source code accompanying this arti- 
cle (see “Availability,” page 3) implements 
the framework of this architecture. It is 
written in C++ and should be fairly easy 
to port. I encourage you to develop the 
architecture into an image-processing li- 
brary custom fitted to your specific envi- 
ronment. For small systems, it should al- 
low processing pipelines of considerable 
complexity. For multiprocessor systems, 
it should allow multiple renders to coexist 
without malicious contention for re- 
sources. 

The Silicon Graphics Imagevision Li- 
brary provides a superset of all the fea- 
tures I describe here, and I recommend 
that IRIX users evaluate it. However, it is 
not available for other platforms. 
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RaveKit: A Portable 








A cross-platform, 


renderer-independent 
3-D toolkit 





Mark Carolan 


ust as text-based terminals were an 

improvement over punch cards and 

Xerox-inspired GUIs were an easier 

interface for casual users, recent 
trends suggest a transition to 3-D depth- 
sorting to break down the complexity of 
multi-windowed applications. In this ar- 
ticle, I present a general-purpose, cross- 
platform framework called “RaveKit” for 
creating interactive 3-D environments 
that provide an alternative way of pre- 
senting graphical data and obtaining user 
input. RaveKit demonstrates how you 
can use a multiplatform compiler (Metro- 
werks CodeWarrior Gold) to create a 
framework for producing high-resolution 
interactive 3-D graphics— without be- 
ing tied to any particular commercially 
available renderer (QuickDraw 3D, Di- 
rectX, Renderware, and the like). I im- 
plement this renderer-independent strat- 
egy by deriving from a generic Renderer 
class and implementing the specifics in 
the subclass. The actual 3-D transfor- 
mations and projections onto 2-D space 
are done on a vertex-by-vertex basis by 
the class Vector3D, while the preraster- 
izing processing of the output triangles 
is handled by a linked list of Tri3D ob- 
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jects that reference the vertexes of the 
world through indexes. 


The RaveKit Framework 

One of the purposes of the RaveKit frame- 
work (available electronically; see “Avail- 
ability,” page 3) is to provide a simple API 
for 3-D programming without being tied 
to any particular renderer. To this end, I 


provide a Renderer- derived class, called 
Raver, which uses Apple’s RAVE API along 
with the default built-in RAVE engine. 
RAVE is the independent “immediate- 
mode” rasterizing module and Hardware 
Abstraction Layer (HAL) used by Quick- 
Draw 3D. 

The primary difference between “re- 
tained mode” and “immediate mode” is 
the amount of work left to the pro- 
grammer. Retained mode provides stor- 
age of your 3-D world, shape genera- 
tion, lighting, and so on, while 
immediate mode simply rasterizes the 
triangles you send it. This rule is not 
rigid, however. For example, Direct3D 
immediate mode offers lighting and a 





Graphics Framework 


few other services, while RAVE tends to 
stick to the bare essentials. While re- 
tained mode, with its larger feature list, 
is probably more appropriate to a 3-D 
scene builder or VRML designer/player, 
immediate mode offers the compactness 
and speed that is more appropriate to 
games or plug-in software. 

The RAVE HAL is freely available from 
Apple (http://www.quickdraw3d.apple 
.com/) and it runs on PowerPC MacOS 
and 32-bit Windows. One of the most at- 
tractive features of RAVE is that it also 
serves as a standard 3-D API, regardless 
of the rasterizing software. This means 
third parties can provide an alternative 
RAVE engine while maintaining a consis- 
tent API. The RAVE documentation (avail- 
able from Apple as a PDF document) pro- 
vides specifications for creating your own 
engine, along with recommendations on 
which facilities must be provided and 
which are optional. For 3-D software and 
content developers, this removes the pain 
of having to learn a different API for each 
rendering engine. For engine developers, | 
it offers a method of packaging a hard- 
ware-accelerated engine in a way that can 
be easily evaluated and incorporated into 
RAVE-savvy applications (including Quick- 
Draw 3D). 

Dropping in your favorite immediate- 
mode rendering library (as an alternative 
to RAVE) simply requires deriving a class 
from Renderer that implements the 
specifics of your renderer. For example, 
if Windows is your only required platform, 
you could call up the Direct3D immediate- 
mode API (which also offers rasterizing 
and HAL services, and is freely distribut- 
able). I have used triangles, as they are 
the most widely used primitive in com- 
mercial renderers. With some modification 
(mostly relating to clipping and depth sort- 
ing), you could incorporate quadrilaterals, 
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(continued from page 30) 

ellipsoids, or other types as primitives. 
The heart of the rasterizing process oc- 
curs in the derived class’s TimeSlice() 
function. TimeSlice() is passed an un- 
signed long containing bit values for any 
key combination returned from the 
Scanner class in main(). Scanner is a 
cross-platform asynchronous keyboard- 
scanning module, a frequently used tool 
in my class-library package. Note in List- 
ing One (listings begin on page 82) that 
the RAVE calls are preceded by “QA,” 
while RAVE data types are preceded by 
“TQA.” Similar to the Direct3D COM in- 
terface, RAVE calls are implemented as 
macros that refer to the virtual functions 
within the various modules. The macros 
also act as a protection for the pro- 
grammer against future modifications to 
the vtable structures. 

Compared to RAVE, Direct3D immedi- 
ate mode offers more services (for exam- 
ple, lighting and clipping). RAVE, on the 
other hand, offers the bare minimum, but 
is a much simpler API. Both make exten- 
sive use of floating-point arithmetic, and 
therefore require either the PowerPC (in 
the case of RAVE on MacOS) or Pentium 
on Win32 (not compulsory, but advisable). 
Both also respond well to hardware ac- 
celeration. A test I did on the program 
presented here on a prerelease Mac with 
the ATI RAGE chipset on the mother- 
board produced startling performance at 
640x480x16, even in RaveKit’s current un- 
optimized format. 

The Vertex3D class (Listing Two) does a 
lot of the useful work and helps to delin- 
eate the abstract “world” rendering stage 
(done in Renderer) from the viewport pro- 
jection stage. Having this clear demarca- 
tion between stages will make it much eas- 
ier to incorporate extra functionality later. 

The projection stage, handled by each 
of the vertex objects (which are actually 
aliases of Vector3D objects), is one of the 
most arbitrary in the process. Until ev- 
eryone has PCs with hardware on par with 
a dedicated graphics workstation, real- 
time 3-D is the art of the possible. As 
programmers and designers, we are not 
necessarily concerned with physically ac- 
curate representations of reality, but are 
looking for a way to present our con- 
cepts as faithfully as resources allow. This 
usually means a constantly shifting com- 
promise between ease-of-use, accuracy, 
detail, and frame rate. With RaveKit, I fo- 
cus on ease-of-use and detail. The de- 
fault pixel resolution is 640x480 with a 
16-bit color depth. 16-bit color is, inci- 
dentally, RAVE’s home turf. 

The Vertex3D object also plays a part 
in the world transformation stage by trans- 
forming its own world coordinates ac- 
cording to instructions passed from the 
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Renderer class’s MoveWorld() function; 


~ see Listing Three. 


One obvious optimization to be done 
in the Vector3DTransform stage (Listing 
Four) is to create lookup tables for the 
sine and cosine values that are required 
if any rotations are necessary. This is 
straightforward, as there are currently only 
three possible increment values for inter- 
active Roll, Pitch, and Yaw. For this arti- 
cle, however, I haven’t bothered, because, 
with the relatively small number of ver- 
tices in this world, there is little visible dif- 
ference. (On the Mac, I’ve used “LibMoto,” 
Motorola’s optimized PowerPC math li- 
brary, which probably helps minimize the 
difference.) 

For storing all the required vertices in 
the “solid” part of the world (that is, the 
vertices that move as one unit), I’ve used 
an array, allowing fast lookup from the 
linked list of 77i3D objects, which store 
the triangles as indices into the storage 
array (Listing Five). In a more demand- 
ing application, this array would need 
dynamic-sizing capability in, say, 1-KB 
chunks. 

For demonstration, I’ve included a rudi- 
mentary mesh builder that allows an ini- 
tial transformation and translation of a 
four-sided “panel” and a simple DXF im- 
porter. The DXF importer works on the 
POLYLINE/VERTEX combination (with the 
mesh specification) on DXF files export- 
ed from my little Swivel3D program, but 
you may need to tune it a little to read al- 
ternative DXF configurations. Since this 
program deals with triangles, it shouldn’t 
be too difficult to get graphic data from 
other programs into this format. 


RaveKit Enhancements 

Adding a few bells and whistles to the 
RaveKit mini-renderer isn’t difficult. I’ve 
simulated basic static lighting by calculat- 
ing a light “strength” for each Tri3D ob- 
ject by reading a combination of distance- 
from-light-source and triangle surface 
normal, then tweaking the RGB values of 
each vertex accordingly. Colored lighting 
is basically there for free if you want it, 
by biasing light intensities toward the cho- 
sen color. Shadowing could be imple- 
mented with a bit of raycasting, but it just 
depends how much processing power 
you're prepared to donate. Texture map- 
ping is already supported by RaveKit, and 
functions are provided in the Raver sub- 
class for storing, animating, and attaching 
bitmaps. 

While this approach doesn’t offer the 
range of built-in features in a compre- 
hensive renderer like Direct3D or Quick- 
Draw 3D, there are some benefits to us- 
ing an immediate-mode 3-D API, rather 
than relying on the more proprietary 
retained-mode interface: 


e It keeps the top level API very lean, so 
incorporating new rasterizing technology 
doesn’t require writing a lot of new calls. 

e You can make more use of some of the 
excellent code examples provided by 
leading game developers and, of course, 
the reams of source code available on 
the Internet (it took me about 45 sec- 
onds to get information on the DXF file 
format for this article). 

e A small package like this is very easy 
to install. The core program itself is 
tiny, and the RAVE run time is only 
around 120 KB. It can be dropped into 
the local directory, so you don’t need 
to inflate the user’s extensions or sys- 
tem folder with yet more DLLs that 
they will rarely use. This also makes 
it a candidate for a utility ActiveX com- 
ponent. 
Perhaps most important— especially for 
game developers— is the ease with 
which you can port to other platforms. 
As long as the API handles triangles, you 
can use the same code with a few cus- 
tomizations in your Renderer- derived 
class. This is of particular significance 
for porting to console platforms since, 
to my knowledge, there are no com- 
mercial retained-mode libraries that run 
on both consoles and PCs. 
Collision detection is practically automatic. 
Rather than duplicating a lot of the pro- 
cessing already done by a retained-mode 
renderer in order to sort nearby objects 
and surfaces, you already have this in- 
formation, since each Vertex3D object 
has explicitly tested its relationship with 
the player. 


Conclusion 

Having explained the benefits of immedi- 
ate mode over retained mode, there are 
also advantages to using an immediate- 
mode 3-D rasterizing engine instead of 
writing your own. These advantages in- 
clude built-in hardware acceleration sup- 
port, Gouraud shading, texture mapping, 
transparency, and z-buffering. (Actually, 
an optimization of this example program 
would be to switch off RAVE’s built-in 
z-buffering, which may be overkill if 
your world is fairly simple, and provide 
your own instead.) And for those of you 
clever and resourceful enough to write 
your own rasterizing stage and HAL, 
there may be benefits to packaging it 
into a standard API specification such as 
RAVE and licensing it to graphics appli- 
cation developers. 

The advantages of having that third di- 
mension available, at relatively little extra 
cost in effort, are apparent once you start 
making use of it. 


DDJ 
(Listings begin on page 82.) 


Dr. Dobb’s Journal, July 1997 


Now that APC Smart-UPS’ includes FREE 
web-enabled PowerChute’ plus, protecting 
network uptime has never been easier 





Y 
I 
I 
I 


MAGAZIN 













Power problems 
attack networks 
relentlessly. To 
protect hardware 
and data from sys- 
tem crashes, experts, network 
managers and computer users 
worldwide prefer one solution 
above all others combined: APC 


plug-in, which allows 
you to integrate your 
Smart-UPS with your 
existing SNMP man- 
agement strategy. 





Smart-UPS and 
PowerChute plus provide 
the complete solution in one convenient 
Smart-UPS. Now, all 120V Smart-UPS box. Server protection and peace of mind 
include FREE PowerChute plus power have never been easier. 
management software. Plan for and control crisis situations ee ee ee ee ee 


PowerChute plus FlexEvents™ lets you Trade-UPS! 
a 


The most reliable protection you can buy control UPSs reactions to power events. 
Fax or mail this coupon to APC and learn 











i : 
i i 
i i 
: | 
: . i 

Smart-UPS provide complete protection You can configure PowerChute plus to i how you can easily trade in your old UPS : 
: : ; ; i é i 
against power spikes, surges, brownouts, provide graceful, unattended server shut- _;_ r discounts towards a new Smart-UPS. 

i . ee 

’ : I I’m interested in trading up an older 
and blackouts. You'll also | down during an extended [_] YES Senate a APG UBS ts Smear UPS, 2 
gain maximum server up- power outage or alert Please send Trade-UPS info. ! 
time and decrease manage- you to out-of-bounds ' [] NO !'m not interested at this time but please I 
hi Py ; or i send my FREE power protection handbook. i 
ment costs. Award-winning environmental conditions 
features include: 3 before they result in vou: 
¢ CellGuard™ intelligent bat- costly downtime. me: 
, j Company: i 
tery management monitors 
; Address: i 
battery performance and Web server and S hater 
: i i 
extends battery life. | SNMP ready 1 State: 2p cout 1 
e SmartSlot™ internal acces- PowerChute plus provides unattended APC’s NEW WebAgent™ b Pieae: i 
‘ system shutdown and UPS management ; j i 
sory slot lets you customize j, Windows NT, Netware and other lows you to monitor | How many servers on site? 
and enhance the perfor- servers. Manage Smart-UPS via SNMP, and manage your Smart- __|__ Brand of UPS used? ! 
. t 

mance of your Smart-UPS. DM! and Web browsers (shown above). typ¢ using your Web 
Features vary by operating system. \ j 
© QuickSwap™ user-replace- browser. New WebAlert™ 
able batteries can be quickly and safely notifies users of Web server shutdown via (888) 289-APCC x8116 
: : 
swapped out without powering down the their browser. PowerChute plus also : Fax: (401) 788-2797 
connected equipment. includes the PowerNet™ SNMP Agent http://www.apec.com 
Sates antennae See eerie 


©1997 APC. All Trademarks are the property of their owners. SU01EF ° (800)347-FAXX PowerFax * CompuServe:GOAPCSUPPORT °¢ ~— E-mail: apctech@apcc.com ~° 132 Fairgrounds Road, West Kingston, RI 02892 USA 


APC has won.more awardstor reliability. 


than all other-UPS-vendors combined, 





CIRCLE NO. 356 ON READER SERVICE CARD 














ape mins 


BEF 


sec 
RSI O 




















- tee once was a time when 


objects meant 
fe) oss t-Vel (akc) 


Now, it’s all about 
—sesleleouesloele 


POET Software's easy-to-use object-oriented solutions 
give developers new power over complex information. 
PN ato italia (-1sm\ele maul gamaal-me(-ci(e/amao)anle)i(e-1d(elamelmialegia-|\cmel-it-Miaicon- 
competitive advantage. At companies like Echelon Corp., Honeywell Inc. 
rave MN (o)V(=1| Pre(=\{=1 (6) 01-1 ew -1 a -MUCl| ale Mel6|ar-l0\7-]a(ecle mel-1t-]e)-\\-m ta a) ale) (ele )Vmne) 
folU ima alom paves jm@oleale)(-> al avce)ganr-1u(elamcem els alam sal-masvo-valiagl-(e]ial-1e\om Vola 
And now we're offering you the same opportunity. To find out how you 
can use objects to bring it all under control, go to www.poet.com and 


download a free SDK. Or call us directly at 1-800-950-8845. 


POET 


SOFTWARE 


The object is empowerment. 


© 1997 POET Software Corporation. POET Software is a registered trademark. 
~All names are registered trademarks of their respective companies. 











Motion Blur Effects 





Greater realism through 
special effects 





Tim Wittenburg 


ost of us have taken pictures that 
ended up looking blurry. Usually, 
the cause of the blur is the sub- 
ject moving through the camera’s 
field of view, the camera shutter being set 
on a long exposure, the lens aperture not 
letting in enough light, or the film’s ISO 
rating (film speed) being too low. 

Photographers know that the rate of mo- 
tion a film is capable of capturing without 
blur depends on a combination of factors 
within the camera, such as those just men- 
tioned. The same phenomenon occurs in 
operating a video camera. The video cir- 
cuitry, regardless of the underlying tech- 
nology being used, also has an effective 
exposure. The human eye also has an ef- 
fective exposure. The exposure charac- 
teristics of the sensor (a human eye or cam- 
era, for instance) place a limit on the rate 
of motion that can be captured by that sen- 
sor without blur. Stated simply, when an 
object’s rate of motion exceeds the expo- 
sure limit of the sensor, blur results. 

In contrast, computer- generated im- 
agery techniques have no exposure limit 
associated with them. In effect, the com- 
puter’s “camera” has an infinitely short ex- 
posure, while film, video, and the human 
eye do not. Consequently, rapidly mov- 
ing objects generated by computers dur- 
ing special-effect sequences can appear 





Tim is a systems architect at the Star Tri- 
bune in Minneapolis and author of Visu- 
al Special Effects Toolkit in C++ (ohn Wi- 
ley & Sons). He can be contacted at 
70403.35 70@compuserve.com. 
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“too crisp” if motion blur is not properly 
added to the sequence. In this article, I'll 
present a method for blurring the ap- 
pearance of moving objects. This method 
is applied after a sequence of images has 
been generated. The approach essential- 
ly involves temporal averaging over the 
sequence of output frames. That is, each 
pixel in the blurred output image is the 
average of a number of corresponding 
pixels from surrounding frames. The num- 
ber of surrounding frames is called the 





“blur depth.” Smaller amounts of blurring 
can be produced by keeping the blur 
depth small, say, a value of 2 frames. Larg- 
er amounts of blurring can be produced 
by increasing the blur depth. Figure 1 il- 
lustrates how this method actually works. 
The sequence of images produced during 
animation are on the left side of Figure 1, 
labeled “Original Sequence,” and num- 
bered 1 through 7. 

The blur depth indicates how many in- 
put frames are to be averaged for each 
blurred output frame in the sequence. In 
Figure 1, a blur depth of 2 is used. The 
illustration shows that a blurring window 
is passed over the sequence of input 
frames. Each blurred output frame is cal- 





culated from 4 input frames. The first 
blurred frame is the average of four frames 
in the input sequence. The second blurred 
frame is the average of input frames 2 
through 5. Figure 2 shows an example se- 
quence with a blur depth of 4. 

Using the method just described, you can 
create blurred sequences in which the 
amount of blur in each frame is an even 
multiple of the original frame rate. In other 
words, creating two blurred sequences in 
which the blur window is 4 and 6, respec- 
tively, creates sequences in which the 
amount of motion contributing to the blur 
is 4/30 and 6/30, respectively. This method 
is capable of varying the amount of motion 
contributing to blur only in whole incre- 
ments of the original frame rate. Next, I’ll 
present an enhancement that provides more 
flexibility over the amount of blurring that 
can be added to each frame in a sequence. 


Controlling the Amount of Blur 
The following technique provides greater 
flexibility in the amount of blur that can be 
added to computer- graphic imagery mod- 
els that are composited into a special-ef- 
fects scene. This additional control can be 
provided by oversampling the original se- 
quence. Instead of producing 30 frames 
per second, the same amount of motion 
can be produced in, say, 150 frames per 
second—5 times the original rate. This 
means that each frame in the oversampled 
sequence represents 1/5 of the motion con- 
tained in each frame of the original se- 
quence. By varying the blur-window set- 
ting and applying the blurring operation to 
the oversampled sequence, each resulting 
blurred frame can be comprised of vary- 
ing fractions of the original rate of motion. 
Suppose, continuing with the example, 
that blurring is now applied to the over- 
sampled sequence with a blur window of 
7 frames. Each frame in the blurred se- 
quence now contains 7/5 the original rate 
of motion. What is needed next is a way 
to get back to the original frame rate of 30 
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(continued from page 30) 

frames per second. The original frame rate 
can be achieved by undersampling the 
blurred sequence appropriately. If every 
fifth frame is now taken from the blurred 
sequence, the result is a sequence in which 
the rate of motion is again equal to the rate 
of motion in the original sequence —30 
frames per second. However, the amount 
of blur in each frame corresponds to 7/5 
the rate of motion in each frame of the 
original sequence. From this example, it is 
apparent that the rate of motion blur in 
each final frame relative to the original is 
a fraction in which the denominator is con- 
trolled by the oversampling rate and the 
numerator is controlled by the blur depth. 
Figure 3 illustrates these relationships. 


Software Corner: Blurring Sequences 
Listing One (listing begins on page 84) is 
the motionBlur function, which imple- 
ments the blurring procedure in Figure 1. 
This function takes an image sequence as 
input and applies the blurring algorithm 
as previously described. A blurred output 
sequence of images is produced. The 
firstImagePath is a pathname to the first 
image in a sequence of images that is to 
be blurred. OutputDir is an absolute path- 
name to the output directory into which 
the blurred images are to be placed. The 
numFrames argument indicates the num- 


Figure 3: Controlling the amount of blur. 


ber of frames in the image sequence to 
blur. The value of blurDepth specifies the 
number of images that are to participate 
in the blurring operation. 
DDJ 
(Listing begins on page 84.) 
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Treaps in Java 





A simple and efficient 
general-purpose 
data structure 





Stefan Nilsson 


f you could use only one data structure, 

which one would you choose? A hash 

table? While it supports the basic insert, 

find, and remove operations, it doesn’t 
keep the elements in sorted order. There- 
fore, it can’t efficiently perform some tasks 
that are frequently encountered, such as 
finding the minimum element or produc- 
ing an ordered list of all elements. The 
standard Java packages don’t contain a 
data structure for ordered data. 

What would you require of this ideal, 
sole structure? It should be easy to use 
(and preferably easy to implement); it 
should be able to hold an object of any 
class (as long as you provide a method 
for comparing objects); it should be effi- 
cient in terms of both speed and memo- 
ry; and it should be thread safe. 

The randomized search tree (“treap”), 
devised by C.R. Aragon and R. Seidel and 
described in “Randomized Search Trees” 
(Algorithmica, 10(4/5):464-497, 1996), ful- 
fills all of these requirements, and it of- 
fers the functionality of a general-purpose 


Stefan is a lecturer in the department of 
Computer Science at the Helsinki Univer- 
sity of Technology. He is doing research 
in the area of algorithms and data struc- 
tures. Stefan can be contacted at Stefan 
Nilsson@but fi. 
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sorting routine, priority queue, hash table, 
stack, or standard queue. 


The Data Structure 

The data structure consists of a balanced 
tree. Therefore, an element is never more 
than about /og, n steps away, where 7 is 
the number of elements in the treap and 
log, n is the binary logarithm (you may 
think of Jog, n as the number of bits need- 
ed to represent the number 7 in binary 
notation). 





Being able to access the elements in the 
treap in log n time is a big improvement 
over some of the most common basic data 
structures; see Table 1. 

The treap is reasonably space efficient 
as well. Each element is stored in a node 
in a tree, and each node contains an in- 
teger and two references, one to the left 
subtree and one to the right subtree. 
Hence, to store ” elements in a treap, we 
need nm integers and 2n references. The 
standard hash-table implementation in 
java.util uses 1 integers for the hash val- 





ues and 7 references for the linked lists. 
Furthermore, it uses an array with a size 
that is typically close to n. For example, 
with a load factor of 1.0, the hash table 
will use the same amount of extra space 
as a treap if the table is full and more 
space if it’s only partly filled. One prob- 
lem with the java.util hash-table imple- 
mentation is that the array doesn’t shrink. 
Even if you remove all but one of the el- 
ements, the size of the array is still pro- 
portional to the maximum number of el- 
ements that were stored in the table during 
its lifetime. The treap doesn’t have this 
problem. 


Interface 

Java doesn’t have a general method for 
comparing two elements. Therefore, you 
must make sure that an object that will 
act as a key in a treap implements a com- 
parison method. To assure this, the treap 
package contains an interface, Ordered, 
that declares the abstract method com- 
pareTo() (see Listing One; listings begin 
on page 84). Any class that is to be used 
as a key in the treap must implement this 
interface. 

To illustrate, I'll write a simple class, 
Year, that implements the interface Or- 
dered. You are free to design the class as 
you see fit. The only requirement is that 
you implement the compareTo() method 
(see Listing Two). This is easy in this case: 
You just compare the integers represent- 
ing the years. You need to use an explic- 
it cast to tell the compiler that the argu- 
ment is an instance of the class Year, 
because the comparison method imple- 
ments the abstract method compareTo( ), 
whose argument is of type Ordered. 

With this out of the way, you can use 
the treap in the same way as a Java hash 
table. In this example, you use objects of 
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(continued from page 40) 

the class Year as keys, and strings as val- 
ues. The call to the method keys() returns 
an enumeration of the treap. The enu- 
meration is the standard Java enumeration 
class, whose only purpose is to return the 
keys of the treap in sorted order. Similar- 
ly, the method elements() returns an enu- 
meration of the values. 


Implementation 

If you want to add an element to the mid- 
dle of an array, you have to move a large 
number of other elements to make room 
for the new one. The most common way 
to avoid this problem is to use a linked 
list, where the elements don’t reside at 
consecutive memory positions but are in- 
stead linked together: Each element in the 
list has a reference to the next one. In a 





Table 1: Worst-case time for some 
basic operations in some basic data 
structures. 
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linked list, it’s possible to insert an ele- 
ment in between two other elements just 
by changing two references. However, in 
a linked list, you can’t directly access an 
element in the middle of the list, you have 
to follow a large number of links to find 
it. One standard technique to overcome 
this problem with arrays and linked lists 
is to use a search tree. 

A search tree consists of a number of 
nodes. Each node contains a key and has 
two references, one to the left subtree and 
one to the right; see Figure 1. Note that 
the tree is ordered. All keys in the left sub- 
tree are smaller than the key in the node, 
and all keys in the right subtree are larg- 
er. This property holds for every node in 
the tree. Therefore, it’s possible to search 
the tree in a simple manner. For example, 
to check if the key F is present in the tree, 
you start by comparing F to the key in 
topmost node (the root) of the tree. F is 
larger than E and you know that F must 
be in the right subtree (if it’s in the tree 
at all). 

Next compare F to H, the root of the 
right subtree. It’s smaller, and you turn to 
the left, where you find the key you are 
looking for. You can use the same tech- 
nique to insert a new node. If the key of 
the new node isn’t already present in the 
tree, the search will take you to a posi- 
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tion at the bottom of the tree where the 
new node can be inserted. 

But you still have a potential problem. 
The algorithm above is efficient only if the 
tree is well balanced. For example, if each 
node in the tree has only one child, the 
structure will behave just like a linked list: 
You have to visit every node in the tree 
to find the one at the bottom. There are 
plenty of algorithms available that try to 
keep a search tree balanced. Most of them 
are rather complicated. The treap offers a 
simple solution. 

You will use rotations (the simplest pos- 
sible rebalancing operation) to help keep 
the tree balanced. The idea is to change 
the form of the tree without disturbing the 
order of the keys. The left tree in Figure 2 
is transformed into the right one by a 
“right rotation.” This operation is easy to 
implement— only two references need to 
be updated, and the order of the keys is 
preserved. The corresponding balancing 
operation that transforms the right tree 
into the left one is called a “left rotation.” 

Now comes the stroke of genius. You 
want the tree to look as if it was con- 
structed from a random sequence of up- 
dates. (As R. Sedgewick and P. Flajolet 
describe in An Introduction to the Ana- 
lysis of Algorithms, Addison-Wesley, 1996, 
random trees are nicely balanced. The 
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expected length of an average search 
path is roughly 1.4 Jog,(n—2), and the 
expected length of the longest search 
path is about 4.3 Jog, n.) To achieve this, 
you assign a random priority number to 
each node before you insert it into the 
tree, and you make sure that each node 
in the tree has higher priority than its 
children. If you do this, the tree will have 
the same form as if the nodes had been 
added in priority order (that is random 
order). 

The insertion algorithm is best explained 
by an example. In Figure 3(a) the node 
G (with priority 2) has just been added to 
the treap. It has been placed in the cor- 
rect position with respect to the ordering 
of the keys, but it violates the priority re- 
quirement: It has higher priority than its 
parent. To fix this you perform a left ro- 
tation, Figure 3(b), to move it higher up 
in the tree. G still has higher priority than 
its parent and we perform a right rotation; 
see Figure 3(c). Finally, G is rotated up to 
the root of the tree; Figure 3(d). Now the 
tree fulfills both the key order and the pri- 
ority order requirements. 

At first this algorithm may seem hard 
to implement. It looks as if you would 
have to walk up the tree, which is hard 
since the references point in the other di- 
rection. However, this problem is easily 
overcome if you formulate the insertion 
algorithm recursively; see the pseudocode 
in Example 1. 
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Figure 1: A binary search tree. 
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Figure 2: Rotation. 


Example 1: Inserting a new node 
into a treap. 
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Compared to those of other balanced 
search tree schemes, the delete operation 
is also simple. 


e If the node to be deleted is at the very 
bottom of the tree, you remove it di- 
rectly and no rebalancing is necessary. 

e If the node has only one nonempty sub- 
tree, you remove the node and replace 
it with the root of the subtree. 

e If the node has two nonempty subtrees, 
you look at the priority numbers of the 
roots of the subtrees. If the left subtree 
has the highest priority, you rotate the 
root of this subtree to the left; other- 
wise, rotate the root of the other sub- 
tree to the right. This will move the node 
to be deleted further down the tree and 


ree eS 


you have reduced the original problem 
to a smaller one that may be solved by 
calling the delete algorithm recursively. 


The only piece of code in the Java treap 
implementation that is somewhat compli- 
cated is the enumeration— the object that 
returns the nodes in the tree in sorted or- 
der. A simple solution would be to have 
the enumeration store the latest key that 
was returned and find the next one by 
searching the tree starting at the root. To 
traverse the complete tree in this fashion 
would require at least 7 Jog n time. But it’s 
possible to do it in linear time. The idea 
is to use an explicit stack to keep track not 
only of the current key but also the path 
from the root of the tree down to this 
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node. To find the next node, you contin- 
ue down the tree to the right (pushing the 
nodes onto the stack). If there are no el- 
ements in the right subtree, you instead 
backtrack on the path using the stack. The 
code is complicated because you need to 
check whether you arrived at the current 
node from the left or from the right. 


Finishing Touches 
To turn the treap into a really useful 
general-purpose data structure, you should 









Figure 3: Inserting a new node G with priority 2 into a treap. 


add some more functionality, such as meth- 
ods for reporting the size of the treap, 
removing the minimum (or maximum) ele- 
ment, and creating a clone or a string rep- 
resentation of the treap. You should also 
wrap up the classes and interfaces in a pack- 
age and add Java style documentation. This 
is all straightforward pedestrian program- 
ming. The complete package is available 
electronically; see “Availability,” page 3. 
There are many ways to further opti- 
mize the code. Most of them will yield 


only minor improvements. For example, 
eliminating the recursion from the insert 
and delete methods will make the code 
harder to maintain and the gain is likely 
to be only marginal, since simple function 
calls are efficiently implemented on most 
modern architectures. 

The one optimization that is most like- 
ly to significantly improve the speed is to 
minimize the cost of the comparisons. A 
drastic way to do this is to use integers, 
rather than objects, as keys. The modifi- 
cation of the code is slight. All variables 
of type Ordered should be changed to int, 
and all calls to compareTo() should be 
replaced by an integer comparison. This 
modification will have to be done manu- 
ally, since Java doesn’t (yet) offer a way 
to write code that operates on both basic 
data types and objects. 


Conclusion 

The failure to use an appropriate data 
structure to maintain an ordered dynam- 
ic set of elements is one major reason why 
sO many programs are slow. This prob- 
lem can be solved by using the right data 
structure (and the treap is a very good 
choice). 
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he Atmel AT89C2051 is a low-power, 

high-performance 8-bit microcon- 

troller compatible with the MSC-51 

instruction set and object code. The 
20-pin AT89C2051, with its many hard- 
ware features, is especially attractive to 
8051 developers because it is compatible 
with the 8051 and similar devices, and can 
reduce board space, components, and 
cost. In an application comprised of 
EPROM, address latch, an 8051, and oth- 
er associated components, for instance, 
the 8051 offers enough on-chip digital 
I/O that additional external I/O compo- 
nents may not be required. In a similar 
AT89C2051-based system, however, a sin- 
gle AT89C2051 can replace the EPROM, 
latch, and 8051, providing the system soft- 
ware is limited to 2 KB. 

The AT89C2051 features: 


e 2 KB of on-chip Flash program memory. 
e 128 bytes of internal RAM. 

e Fully static operation: 0 Hz to 24 MHz. 
e Instruction compatible with MCS-51. 

e 15 I/O lines. 

e Full duplex programmable serial port. 
¢ Two 16-bit programmable timers. 


Dhananjay is a scientific officer for the 
instrumentation laboratory at the Inter- 
University Centre for Astronomy & Astro- 
Physics IUCAA) in Pune, India. He can 
be contacted at dug@iucaa.ernet.in. 


46 


e On-chip analog comparator. 

e Low-power and power-down modes. 
¢ Wide operating voltages: 2.7 V to 6 V. 
e 20-pin DIP/SOIC package. 


The use of static memory allows the de- 
vice to be operated at zero frequency. It 
also affords two software-selectable save- 
power modes. Idle mode stops the CPU, 
retaining the contents of the internal RAM, 
allowing the timer/counter, interrupt sys- 
tem, and serial ports to function normally. 





Power-down mode saves the RAM contents 
but freezes the oscillator, disabling all oth- 
er activity until the next hardware reset. 

The amount of PEROM (programmable 
and erasable read-only memory) avail- 
able on the AT89C2051 is sufficient for 
most applications, including use in 
portable instruments, supervisory- control 
applications, autonomous robots, and 
more. Use as controllers in portable in- 
struments is further simplified by the low 
power consumption and wide operating 
voltage range. 


Atmel’s AT89C2051 
Microcontroller 





The AT89C2051 allows 15 bits of I/O, 
configured as 8 bits on Portl and 7 bits 
on Port3. Portl and Port3 are compatible 
to the P1 and P3 on an 8051 (except 
Port1.0 and Port1.1). 

Portl pins P1.0 and P1.1 require exter- 
nal pullups. P1.0 and P1.1 pins also serve 
as inputs to an on-chip analog compara- 
tor (+ve and —ve inputs, respectively). 
Portl output buffers have a 20 mA sink 
current capacity and can drive LEDs di- 
rectly. By writing ones to the Port1 bits, 
they can be used as input bits. 

As Table 1 shows, Port3 pins P3.0 to P3.5 
and P3.6 are seven bidirectional I/O pins 
with internal pullups. P3.6 is internally con- 
nected to the output of the on-chip com- 
parator and is not accessible as a general- 
purpose I/O pin. Port3 bits can also sink 
up to 20 mA of current, and when written 
with ones, can be used as inputs. Port3 
pins also serve alternate functions (to be 
discussed shortly). If the user wants to use 
these alternate functions, the pin cannot 
be used for general-purpose I/O. 

The AT89C2051 data sheet states that 
the on-chip oscillator can be used with 
a ceramic resonator as well as a resonant 
crystal element to provide the basic clock 
to the microcomputer. An external clock 
source with suitable levels can also be 
used instead of a crystal or a resonator. 
The operation is similar to that of an 
8051. AT89C2051 can be operated with 
a clock frequency between 0 and 24 MHz. 
This is possible because the chip uses 
static memory. 


Special Function Registers 

The AT89C2051 has a register set identi- 
cal to an 8051. Thus, it is possible to port 
existing 8051 applications to an AT89C2051 
without change to the object code — as 
long as the software limits itself to the 
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(continued from page 46) 

available hardware resources, including 
memory and ports. This means that all 
jumps (jmp) and calls call) must be lim- 
ited to maximum physical address 0x7FF. 
This also applies to all the other instruc- 
tions that access memory in some form 
(for example, cjne, jmp @A + DPTR, jnb, 
and the like). Since the controller does not 
support external DATA or PROGRAM 
memory access, you should not use these 
instructions. 


Programming the AT89C2051 
Until you have a suitable “programmer’— 
a device similar to a PROM burner— using 
the AT89C2051 can be trickier than it 
would be with a simple 8031 or 8751. 
However, once a suitable programmer is 
available, using the microcontroller is 
straightforward. The AT89C2051 micro- 
controller can endure one thousand pro- 
gram and erase cycles. In this section, 
I'll present a simple programmer for 
AT89C2051 that is hosted on a 8052-based 
circuit running a Basic interpreter. 

The AT89C2051 can be programmed us- 
ing a suitable programmer out of the target 
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Figure 1: Programming the Flash 
memory in AT89C2051. 
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system. Table 2 identifies the various modes 
for erasing, programming, and verifying the 
chip. The code memory is programmed one 
byte at a time. After the controller has been 
programmed, to reprogram any nonblank 
byte, the entire chip has to be electrically 
erased. Erasing the chip is a simple task that 
takes a few milliseconds to execute. 

The Atmel application sheets describe a 
simple programmer that lets you perform 
a variety of operations with the flash con- 
troller, including erasing, reading, pro- 
gramming, and verifying the contents of 
the target chip (see http://www.atmel 
.com/atmel/products/prods10.html). How- 
ever, the driver software for the program- 
mer does not support IntelHex object files. 
You can also purchase off-the-shelf pro- 
grammers for these devices (see Airborn 
Electronics at http://www.airborn.com 
.au/ab120.html, for instance), or see if an 
existing programmer can be upgraded. I 
didn’t have the time to build the circuit of- 
fered by Atmel, or to see if my existing 
EPROM/controller programmer could be 
upgraded to program the Atmel chips. Con- 
sequently, I decided to build a simple pro- 
grammer using circuits I had available. 

Since my lab already uses 8052-BASIC 
systems for various applications, I decided 
that I could add a little circuit to an exist- 
ing 8052-BASIC evaluation board we built 
to make a simple (erase/program/Vverify) 
programmer. I found I could modify an ex- 
isting IntelHex loader program for the Ba- 
sic system to get the required programmer 
code. Figures 1 and 2 show the block di- 
agram for programming and verifying the 
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Figure 2: Verifying the Flash memory 
in AT89C 2051. 
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Table Z ATS9C2051 programming modes. (Note: Internal PEROM aaah is 
reset to OOOH on the rising edge of RST and advanced by a positive pulse on 
XTAL1 pin. Chip erase requires a 10 mS pulse. P3.1 is pulled low during 
programming.) 
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Flash-memory contents of an AT89C2051. 
Figure 3 shows the circuit schematic for 
the programmer. The programmer needs a 
suitable +5V power supply for the 8052 
and +12V supply for the programmer to 
generate Vpp. The +12V power supply 
must be stable and provide a voltage be- 
tween 11.75V and 12.5V. The limits for the 
programming voltage for the AT89C2051 
are between 11.5V and 12.5V. A suitable 
20-pin ZIF socket can be used to insert and 
remove the AT89C2051 chip. Listing One 
(listings begin on page 55) is the Basic pro- 
gram for programming the AT89C2051. A 
PC with an 8051 assembler and terminal- 
emulation program (I use Vterm) are the 
only tools required for programming and 
using the AT89C2051. 

To find out if my programmer was cor- 
rectly burning the code into the 
AT89C2051, I used the test code in List- 
ing Two. After I was satisfied that things 
were working, I went ahead with more 
serious applications. 


Using the Programmer 

To use the programmer, the ZIF socket 
is loaded with the AT89C2051 to be pro- 
grammed before power is applied to the 
system. This is followed by applying pow- 
er (+5V as well as +12V) to the circuit. 
The Vpp generation circuit applies a log- 


ic 0 to the RST pin at power on. Subse- 
quently the 8052 system is loaded with 
the code in Listing One from within the 
terminal-emulator environment. To com- 
municate with the 8052-BASIC system, 
the terminal emulator can use any stan- 
dard baud rate as well as transmission 


The amount of 
PEROM available is 
sufficient for many 
applications 





settings (number of bits, parity, and so 
on). However, the 8052-BASIC requires 
that, after power on, the host sends a 
SPACE character as the first character. 
This allows 8052-BASIC to adjust to the 
baud rate and other transmission settings. 
After getting the READY prompt, Listing 
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One is downloaded and executed. The 
Basic program is then ready to accept 
IntelHex format object files. The received 
hex code is stored in the External RAM 
of the 8052 system. After the hex file is 
successfully received, the programmer 
proceeds with erasing the AT89C2051, 
then begins programming it with the user 
object code. After the code is burnt into 
the chip, the programmer power supply 
is turned off before removing the target 
chip. The target chip is then ready to be 
inserted into the target system. 


Using the AT89C2051 
A 


good use for this controller is in any ap- 
plication that needs to keep current con- 
sumption low, with features like power- 
down, or sleep modes of operation, and 
that have a serial port, timers, interrupts, 
and I/O pins. 

For instance, I needed a 12-bit multi- 
channel ADC to connect to PCs in a cer- 
tain application. Rather than invest in new 
parallel ADCs, I decided to see if our ex- 
isting inventory of MAX186 ADCs could 
be of any use. MAX186 had everything 
we needed, except that the chip oper- 
ates at serial clock with a minimum clock- 
frequency requirement of 100 KHz (which 
would be difficult to generate under pro- 
gram control on older PCs). Consequently, 
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I decided to build a general-purpose in- 
terface that could be used in other appli- 
cations. I found that the AT89C2051 
worked well. The result of my design was 
a solution that offers a nibble wide input 
and output interface that, though tailored 
to connect to the PC parallel port, could 
be used anywhere else. 


Using an 8051 capacity controller to 
parallelize serial ADC data might be con- 
sidered overkill. While there are parallel 
output 12-bit multichannel ADCs of sim- 
ilar performance, I decided to use avail- 
able components to get the system work- 
ing. The AT89C2051 uses its serial port 
signal pins TxD and RxD to connect to 
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Table 3: Modes of operation. 
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‘Start ADC conversion on channel 6 
Start ADC conversion on channel 7 : 
_ Read nibble 0 of the last ADC conversion result 
__ Read nibble 1 of the last ADC conversion result 
_ Read nibble 2 of the last ADC conversion result 
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the MAX186. The microcontroller serial 
port operates in mode 0, in which the 
serial port works as a shift register, either 
as input or output. In the shift register 
mode, the TxD pin supplies the shift 
clock, and the RxD pin provides the data 
or reads the external data as per the di- 
rection. The controller programs the se- 
rial port as an output shift register in the 
beginning of the acquisition cycle during 
which the MAX186 needs the 8-bit con- 
trol byte that contains conversion pa- 
rameters, channel number, and so on. Af- 
ter the 8-bit data is shifted out, the 
controller program converts the serial port 
as an input shift register and reads back 
the converted ADC data as 2 bytes. Fig- 
ure 4 shows the block diagram, and Fig- 
ure 5 (see page 55) shows the circuit 
schematic. Figure 6 shows the wiring 
scheme to connect the controller board 
to the PC printer adapter. 
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Figure 3: Programmer for the AT89C2051. All resistors are 5 percent CFR, except R5 and R6, which are 1 percent MFR. 


Transistors are BC547. 
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Trigger 


(continued from page 50) 
The user interface of the converter con- 
sists of the following signals: 


e 4 bits of mode inputs that determine 
the mode of operation for the con- 
verter. 

e A trigger input that triggers the converter 
into the requested mode. 

e A clear-status input that is used to erase 
previous status information. 


Figure 4: Connecting the AT89C2051 to serial ADC. 
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The converter outputs are: 


e 4 bits of data. 

e A done flag that indicates the end of op- 
eration. 

e An error flag indicating an attempt to 
launch a nonimplemented mode of op- 
eration. 


The mode input to the converter de- 
termines what task the controller will 





D.. to popular demand, Dr. Dobb’s has collected 
another volume of programming languages and tools. 

The editorial staff of Dr Dobb’s has once again assembled the 
most useful, interesting, and essential programming languages 
available and created The Alternative Programming 


Languages CD-ROM, Volume 2.0. This newest release 
contains over 35 programming languages, plus a large 
number of tools and utilities all on this one CD-ROM. 


Whether involved in object-oriented development, internet 
_ development, text processing or document formatting, this 
_ definitive collection of languages and tools will help any 

serious programmer increase their productivity and reach 
_ that next level of programming excellence. 
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e Cocktail ¢ Python Tcl ¢ Bob ¢ Perl ¢ Bob DLL © ReXX 
e Netrexx ¢ Lout ¢ Ghostscript ¢ Slang ¢ Lec ¢ Gnu C 

e CSC ¢ Modula 2 © G77 © Pascal ¢ Dylan ¢ Forth * Neudl 
© Quincy ¢ D-Flat ¢ D-Flat++ ¢ And more! 
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come with source code for compilers or — 


nterpreters, enabling you to put this 
CD-ROM to work immediately on your 
programming projects. This is truly the 


most extensive collection of programming ) 


anguages ever assembled. 


Visit our web site for a more 
detailed explanation - 
www.ddj.com/cdrom/ 

ORDER TODAY! 
U.S. & Canada: 
800-992-0549 
All Other Countries: 
913-841-1631 
E-mail: orders@mfi.com 
Fax Orders: 913-841-2624 
Mail Orders: 
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1601 West 23rd St., Ste. 200 
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perform when it is triggered. With 4 bits 
of mode input, up to 16 modes (see Table 
3) of operation can be implemented. For 
this design, only 11 combinations are re- 
quired; the rest can be used later for ex- 
pansion. 


Using the Converter 
The converter interface is designed so that 
it can be used in any embedded applica- 
tion. The interface is ideally suited for data 
acquisition on PC compatibles using the 
parallel printer adapter signals. The con- 
verter provides access to eight channels 
of 12-bit ADC. The analog input voltage 
range of the ADC is 0 to 4.095 volts and 
at 12 bits, a resolution of ImV. 

Listing Three is C code to interface the 
controller through the PC parallel port. 


Conclusion 

I first heard about Atmel microcontrollers 
from Russ Hersh’s 8051FAQ. I thank Tina 
Anagnos, David Lee, and Jim Tatsukawa 
at Atmel Corp. (http://www.atmel.com/) 
for providing data sheets, answering my 
questions regarding the programmer, and 
for providing AT89C2051 samples. My 
good friend Dr. Pramod Upadhyay need- 
ed a 12-bit AD converter for PCs just 
when I was looking for an application. 


DDJ 
(Listings begin on page 55.) 
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modes (03) : 


—_mode_1 (D1) © 
done (S3) 
mode_0 (D0) 
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__ Trigger (CO*) < 





Figure 6: Wiring diagram for 
connecting the interface to the 
printer port. 
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RETURN 
MXAD=8001H: EXAD=8000H 


EMBEDDED SYSTEMS 


Listing One 


REM Programmer for ATMEL AT89C2951 
Print "Atmel AT89C2051 Programmer" 
Print " Accepts IntelHex files " 
Print " Dhananjay V. Gadre " 
Print " 1996 x 


XBY (4CQ@@H) =@@C2H: 
XBY (4C@3H) =@@D2H: 
XBY (4C@6H) =@0C2H: 
XBY (4CQ9H) =@@D2H: 
XBY (4C@cH) =@@C2H: 
XBY (4COfH) =@OD2H: 
XBY (4C12H) =@0C2H: 
XBY (4C15H) =@@D2H: 


XBY (4C@1H) =O@B2H: 
XBY (4C@4H) =O@B2H: 
XBY (4CQ7H) =OOB3H: 
XBY (4C@aH) =O0B3H: 
XBY (4C@dH) =OOB4H: 
XBY (4C10H) =OQB4H: 
XBY (4C13H) =O@B5H: 
XBY (4C16H) =OOB5H: 


XBY (4C@2H) =@022H 
XBY (4CQ5H) =0622H 
XBY (4C@8H) =@022H 
XBY (4CO@bH) =@022H 
XBY (4C@eH) =@022H 
XBY (4C11H) =0022H 
XBY (4C14H) =0622H 
XBY (4C17H) =0622H 


PRINT "Erasing AT89C2051...": CLOCK1: PRINT TIME 


MTOP=41FFH rem RST=H, P3.2=H 


A=GET : IF A=@ THEN 10 EX=@@@Ah: XBY(EXAD)=EX: call 4c@6h: call 4c@ch 
IF A<> 58 THEN 10 REM Wait 1@ ms 
PRINT CHR(A), for t=@ to 5: next t 
CSUM=@ REM Set P3 for Erase 
GOSUB 1080 MX=@0@4h: xby(MAXD)=MX: call 4c@@h: FOR T=@ TO 5 : NEXT T 
LL=A : IF A=0 THEN 23@ REM Set RST to 12V 
CSUM=CSUM+LL EX= EX .AND. @@FDH: XBY(EXAD)=EX: FOR T=@ TO 5: NEXT T 
GOSUB 100@ REM Set P3.2 to @ 
ADDR=256*A EX=EX .AND. @@F7H: XBY(EXAD)=EX: FOR T=@ TO 5 : NEXT T 
CSUM=CSUM+A REM Set P3.2 to l 
GOSUB 1000 EX=EX .OR. @@@8H: XBY(EXAD)=EX 
ADDR=A+ADDR: IF ADDR > 1FFFH THEN GOTO 4080 REM Put RST to 5V 
CSUM=CSUM+A EX=EX .OR. @@@2H: XBY(EXAD)=EX 
GOSUB 1@0@: IF A<> @ THEN 23@ PRINT "AT89C2@51 Erased..." 
FOR T=1 TO LL PRINT "Writing and Verifying..." 
GOSUB 100@ FOR COUNT=0 TO @7FFH 
CSUM=CSUM+A VAL1=XBY (42@@H+COUNT) 
XBY (ADDR + 4200H)=A REM Set P3 to WRITE data 
D=CBY(ADDR + 42@@H): IF A<>D THEN PRINT "ERROR" MX=@@38H: XBY (MXAD) =MX 
IF A<>D THEN GOTO 300 REM Put data on Pi 
ADDR=ADDR+1 PORT1=VAL1: CALL 4C12H 
NEXT T REM Put RST to 12V 
GOSUB 180@ EX=EX .AND. @@F9H: XBY(EXAD)=EX 
CSUM=CSUM+A : CSUM=CSUM .AND. @@FFH REM Put P3.2 to @ 
IF CSUM<>@ THEN 3000 EX=EX .AND. @@F7H: XBY(EXAD) =EX 
PRINT : GOTO 1@ FOR T=@ TO 5: NEXT T 
GOTO 2000 REM Put P3.2 to 1 
A=GET: IF A=@ THEN 1000 EX=EX .OR. @@@8H: XBY(EXAD)=EX 
PRINT CHR(A),:IF A<58 THEN A=A-48: GOTO 103@ REM Disable data from source 
A=A-55 CALL 4C15H 
C=A EX=EX .OR. @@@2H: XBY(EXAD)=EX 
A=GET: IF A=@ THEN 1040 REM Set P3 to read data 
PRINT CHR(A),:IF A<58 THEN A=A-48: GOTO 107@ MX=3@H: XBY (MXAD) =MX 
aefon (continued on page 59) 
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Serialize.h++ 


= Allows you to modify 
only your C++ apps; no 
need to change your | 
Java apps 


= Offers a way to exchange 
data and objects easily _ 
between C++ apps and 
any Java apps that use 
the Java serialization 
mechanism 


= Includes pre-built 
ReaderWriter objects 
that map popular 
Tools.h++ classes to 
corresponding classes 
in the Java core libraries 


JTools 2.0 


= Allows exchange of data | 
and objects between Java 


apps and any C++ app 
that uses Tools.h++ | 
virtual streams 


= Provides virtual streams 
for Java classes that 
correspond to the 
Tools.h++ virtual stream 
mechanism 


= Includes pre-built 
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Tools.h++ classes to 
corresponding Java core 
library classes or to 
JTools classes 
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= Packed with over | 20 
reusable foundation-level 
classes for all your C++ 
development needs 


= Includes virtual streams _ 


for persistence 


= Provides a higher-level 
interface to the Standard 
C++ Library 


Standard C++ Library | 


=™ Includes updated data 
structure and algorithm 
classes, plus string, 
numeric limits, complex 
classes, and allocators 

=™ Chosen by many major 


vendors, including 
Borland, Sun, DEC, SGI, 


and HP for inclusion with 


their standard-compliant 
C++ compilers 
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Serialize.h++ gets your C++ and Java apps 
to “speak the same language.” Make changes only 
to your C++ apps—there’s no need to change 
your Java code. When you use our C++ imple- 
mentation of the Java serialization mechanism, 
your C++ apps can exchange objects and data 
with any Java app that uses the Java serial- 
ization mechanism. It’s that simple. 

Plus, we include pre-built 
ReaderWriter classes that map 
popular Tools.h++ classes to 
corresponding classes in 

the Java core libraries. 





























We make it easier for you 


JTools 2.0 includes Java virtual streams, a 
set of classes for exchanging objects between 
your Java and C++ programs with a minimal 
amount of programming, Virtual streams work 
on both sides of the equation: Java objects are 
serialized into Java virtual streams using 
Tools.h++ virtual streams format, and the 
objects written with Tools.h++ virtual 
streams can be decoded using Java 
virtual streams. JTools 2.0 
includes a set of pre-built 
Streamers that map 
Tools. h++ classes to 
Java core library or 


JTools classes. 


Rogue Wave and .h++ are registered trademarks of Rogue Wave Software, Inc. All other trademarks are the property of Rogue Wave Software or their respective holders. 





Rogue Wave gets them talking. 


— C++ and Java are different languages...so how do you exchange data between 
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them? With Rogue Wave’s C++/Java Interoperability Suite, you can get 


your apps to talk to each other, so you can take advantage of the 





portability of Java while continuing to leverage the benefits of 








C++ in your applications. 


Both JTools 2.0 and Serialize.h++ give you the power 
and flexibility to get your Java and C++ apps 
communicating. When you use them along with the other 
products in the Interoperability Suite, you get reliability 
and portability, plus you save time and effort by using 
(and reusing) our well-designed classes. Rogue Wave 
also offers proven, world-class products for developing 
visual, math, database, and distributed apps, as well as. 
support and training to help you get the most from 
your development efforts. 





When you use Tools.h++ to build your 
C++ apps, you get over 120 tested and proven 
foundation classes including sets, bags, sorted 
collections, strings, dates and times, and 
virtual streams. Even if you don’t face inter- 
operability challenges now, you can use the 


that will be ready to communicate with Java 
apps that use the virtual streams in Tools. 
Tools.h++ also provides a higher-level OO 
interface to the Standard C++ Library. 


When you add Rogue Wave's implementation 
of the Standard C++ Library to 


head start on ANSI compliance, but you also 
unleash even more useful features in Tools.h++ 
(such as extended regular expressions). Plus, 
Standard C++ Library classes are multithread- 


safe so your code can run in multithreaded 


environments. 


virtual streams in Tools.h++ to build C++ apps your development toolkit, you not only get a 


Find out how Rogue Wave’s Interoperability Suite can help you realize the “write once, run everywhere” 
promise of Java while continuing to leverage the benefits of C++ in your apps. 


For more information, call us at (800) 487-3217 or visit our Web site at www.roguewave.com 


Telephone us in Europe: ROGUE Wave SOFTWARE GMBH: +49(6103)59 34-0 @ ROGUE Wave SorTWare B.V.: +31-20-695 55 11 
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while (plez) { 
gg=g 
g=f 
f=p; 
if ((cond=strcmp(w, p->word))==0) { 
g = p->listtail; 
if (q->line != line) { 
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RUNNING file: concord.c 
running ‘example fiexample\example.c'’ 















struct wnode “split(w, gg. g. fp) 
_ Struct wnode “gg, “g, “t. “p: 
char “w: 

{ 
p->red=1; 
p->left->red = 0; 
p->right->red = 0; 
if (f->red) { 


y->red = 1; 
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(continued from page 55) 


2295 REM Read data and compare 

2300 porti=255: TEMP=PORT1: IF TEMP <> XBY(42Q@H+COUNT) THEN GOTO 5000 
2305 EX=EX .OR. 1: XBY(EXAD)=EX 

2307 EX=EX .AND. OOFEH: XBY(EXAD)=EX 

2310 NEXT COUNT 

2320 PRINT "Chip Programmed Successfully..." 

2330 GOTO 5900 

30@@ REM Error in HEX file 

3010 PRINT "Error in Hex File. Aborting...": END 
4000 REM File not suitable for AT89C2@51 

4010 PRINT "Hex file not suitable for AT89C2051... 
500@ print "COUNT=", count : print temp 

5@@5 CALL 4C@3H : CALL 4CQ9H: CALL 4C@FH: CALL 4C15H 


Aborting": END 


5019 PRINT "Turn Power OFF...": PRINT TIME: CLOCK® 
5020 END 
e e 
Listing Two 
CPU 8@51 
ORG 9080 
mov a, #0; clear accumulator 
for_ever: mov pl, a; transfer to Portl 
inc a 
ljmp for_ever; loop for ever. 
end 
e e 
Listing Three 


#include <stdio.h> 
#include <dos.h> 
#include <conio.h> 
#include <process.h> 
#include<time.h> 


void main(void) 

{ 

int dport_lpti, cport_lpti, sport_lpti, del; 

unsigned char adc_status, adc_val, cport, chan_num; 
unsigned char nib_9, nib_1, nib_2, nib_3, temp, nibble[5]; 


/* Sign ON */ 

clrserQ: 

printf("MAX186 ADC interface for printer adapter using AT89C2051") ; 
printf ("\nD.V.GADRE") ; 


/*Get LPT1 port addresses */ 
dport_lpti = peek (0x40, Ox@8) ; 
if(dport_lpti ==@) 
{ 
printf("\n\n\nLPT! not available... 
exit(1); 
J 
printf("\nLPT1 address = /X", dport_lpt1); 
cport_lpti = dport_lpt1 +2; /* control port address */ 
sport_lpti = dport_lpti + 1; /* status port address */ 


aborting\n\n\n") ; 


/*initialize the ADC strobe signals*/ 
cport=04; 
outportb(cport_lpt1, cport); 


/*clear the status of controller*/ 

/*this generates a low going pulse on C1* pin of the control port*/ 
cport=cport ; @2; 

outport(cport_lpt1, cport); 

cport=cport & Oxfd; 

outport(cport_lpti, cport); 


/* check if ADC is connected & working*/ 
adc_status=inportb(sport_lpt1); 
adc_status=adc_status & 0x@8; 


if(adc_status == 0) printf("\nADC connected\n") ; 
else {printf("\nADC not connected...Aborting"); exit(1);} 


chan_num=0; /*set channel number*/ 
for(:4) 

{ 

/*set channel number to the controller*/ 
outportb(dport_lpti, chan_num) ; 


/*trigger the controller to read the channel number*/ 
cport=cport | @1; 
outportb(cport_lpti, cport); 


/*wait till it reads the channel number and completes conversion*/ 
adc_status=inportb(sport_lpt1) ; 

adc_status=adce_status & 0x@8; 

while(adc_status ==) 

{ 

ade_status=inportb(sport_lpt1) ; 

adc_status=adc_status & 0x@8; 

} 

/*remove the trigger pulse. take it igh to remove the trigger*/ 
cport=cport & Oxfe; 

outportb(cport_lpti1, cport); 


/*clear the status of controller*/ 
cport=cport | 92; 


outport(cport_lpt1, cport); 
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cport=cport & @Oxfd; 
outport(cport_lpt1, cport); 


/*noew read the converted data*/ 
for (temp=8; temp<11; tempt+t+) 
i 
/*set data port to read nibble @, 1 and 2 in that order*/ 
outportb(dport_lpti, temp); 


/*trigger the converter to perform the read nibble process*/ 
cport=cport | 1; 
outportb(cport_lpti, cport); 

/*wait till it completes the task*/ 

ade_status=inportb(sport_lpt1) ; 
adc_status=adc_status & 0x@8; 
while(adc_status ==@) 

{ 
adc_status=inportb(sport_l1pt1) ; 
adc_status=adc_status & 0x98; 

} 

/*remove the trigger pulse*/ 
cport=cport & Oxfe; 
outportb(cport_lpti, cport); 

/*clear the status of controller*/ 

cport=cport ; @2; 

outport(cport_lpt1, cport); 

cport=cport & Oxfd; 

outport(cport_lpti, cport); 


/*read the nibble and store it temporarily*/ 
adc_val=inportb(sport_lpt1) ; 
nibble[temp-8]=(adc_val * @x8@) >> 4; 
} 
/*construct the full 12 bit number from the stored nibbles*/ 
printf("\n /d mV", nibble[@] + 16*nibble[1] + 256*nibble[2]); 
sleep(1); /*sleep for 1 sec*/ 
} 
} 


DDJ 
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INTERNET PROGRAMMING 


Thread Pools and 
Server Performance 








Thread pools can 
save CPU cycles 





John Calcote 


etwork service protocols such as 
HTTP, NNTP, and SMTP have tradi- 
tionally been implemented on UNIX 
platforms as heavyweight process 
servers. When such a server receives a re- 
quest, it starts a child process, passing it 
the request and the client connection han- 
dle via some form of interprocess com- 
munication — usually command-line argu- 
ments, environment variables, and inherited 
file handles. This child process services the 
request, then terminates. These UNIX en- 
vironments are optimized for this sort of 
activity. Processes are cached in memo- 
ry and code segments are reused for 
much-improved efficiency. Still, it is fairly 
time consuming in CPU terms to create the 
process-control block, and maintain the run- 
time resources and bookkeeping informa- 
tion for each executing process. 

Today’s operating systems emphasize 
threads over processes. Under Windows 
NT, for instance, creating a new process 
is much more CPU intensive then creat- 
ing a new thread of execution in an ex- 
isting process. Furthermore, operating sys- 
tems now give you more control over the 
scheduling of threads than of processes. 
Even so, starting a new thread can carry 
a fair amount of overhead with it as well. 





John, an engineer on Novell’s Directory 
Services team, can be contacted at JCAL- 
COTE@novell.com. 
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Some HTTP servers on the World Wide 
Web service hundreds of thousands of re- 
quests per day. If such a server process- 
es only 100,000 requests in a 24-hour pe- 
riod, each request must be serviced in an 
average of 0.864 seconds. Such servers 
cannot afford to use even a quarter sec- 
ond creating a new thread for each in- 
coming client request. In reality, many of 
these requests are being serviced simul- 
taneously. Even UNIX process-oriented 
servers run several copies of the child pro- 
cess request handler at a time. 





In actuality, the number of requests per 
second varies from minute to minute. 
Sometimes, requests come in so fast the 
server doesn’t have time to accept the con- 
nection in a reasonable amount of time. 
Clients experience this in the form of a 
timeout, usually accompanied by a mes- 
sage to the effect that the server is cur- 
rently unavailable. This all depends, of 
course, on the ability of the client to cor- 
rectly interpret a lack of response from a 
server. Some client applications simply tell 





users that the server cannot be found, 
which can be misleading, if not annoying. 

A well-written server application is op- 
timized in two important areas. First, it can 
process connection requests as fast as pos- 
sible. Note that a connection request refers 
specifically to the connection indication 
event generated by the underlying trans- 
port service provider. Second, it can be tai- 
lored by the administrator to politely re- 
ject all simultaneous connection requests 
above a certain threshold number. 


Tried and True 

Typically, a server application is written with 
a listen thread for each port or socket to be 
monitored. This thread might sit in a loop 
sleeping on a call to an operating-system 
socket monitor function, such as the 
Winsock select or TLI listen function. When 
a connect indication is received, this func- 
tion wakes up and returns control to the 
monitor thread, which then attempts to 
receive the indication (or data, in the case 
of a datagram protocol). Once the data or 
indication is retrieved, it must be pro- 
cessed, but the monitor thread needs to 
do this as quickly as possible to get back 
to listening for more connection indica- 
tions. Remember, if the monitor thread is 
not blocking on a call to select, then it’s 
not listening for connection requests. Ex- 
ample 1 is pseudocode that depicts a com- 
monly used monitor algorithm. 

What the server thread does with the 
client’s connection handle is of no con- 
cern to the monitor thread. As far as the 
monitor is concerned, the client has been 
serviced. Although this looks fairly effi- 
cient at first glance, the acts of retrieving 
the connect indication, establishing the 
connection, and starting the new server 
thread can be overly time consuming for 
a truly high-performance server. It would 
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(continued from page 60) 

be nice if one could write code such as 
Example 2, a thread-pool-based moni- 
tor. Essentially, the server application 
maintains a pool of threads that may be 
used to execute the monitor function. 
Each time the currently executing moni- 
tor thread returns from a call to select, 
the first thing it does is reschedule itself 
with the thread pool, starting a new copy 
of the monitor thread and blocking on 
select. Meanwhile, the original monitor 
thread continues, servicing the client re- 
quest to completion. 

Listing One (listings begin on page 86) 
is a simple thread-pool-based server pro- 
gram that monitors a well-known sock- 
et for client requests. This server uses a 


Want to build 
applications for 
the Net? 


Distinct provides the most comprehensive, robust and market tested Internet 
and Intranet components available in the world. Just plug them into your 
applications and deliver solid products fast and on schedule. Every time. 


Share in the experience: 


“We conducted a test session to compare the performance of 
similar products, and Distinct's product was better. Distinct's 
Internet Development Kit allowed us to have the communications 
layer of the package ready in record time. We gained much more 
flexibility than expected due to the number and quality of the 
objects contained in the package.” 

-Dr. Shyam Sunder, Carnegie Mellon University 


“Distinct provided a Telnet OCX/VBX that saved up to 6 months 
of development time and reduced the overall development cost.” 


-Paul Calboun, Tandem Computers 


“The Distinct package includes custom controls that are easy to use, 
reliable, and perform well.” -Darwin Hatheway, 3M Company 


“By using Distinct, CRM saved a lot of time and money and provided 
great solutions for challenging tasks.” -William Gutekunst, 


CRM Technologies 
“It is not often, in today's market, that you can find companies that 


want to find the solution to a customer's problem, no questions 
asked. Thank you.” -Scott G. Phillips, NIN Communications, Inc. 





pseudocode. 


































Distinct Visual Internet Toolkits: just what you should expect from the 
most respected and experienced net components company in the business. 


The world leader in Internet development tools. 


http://www.distinct.com 
sales@distinct.com 
Phone: 1-408-366-8933 
Fax: 1-408-366-0153 


Licensing es required for refsrbuion. Some protons may no beable in alos. isin is regsered ademarsof sinc Grpoaion. Mcrso, Windows, Windows NT and ihe Windows log are reseed trademarks of Mrs Corporation. Cope Distinct Crporaion, 197. 
CIRCLE NO. 125 ON READER SERVICE CARD 














62 


connectionless protocol, which, in this 
case, means that the client passes all re- 
quest data in a single initial packet 
(called a “datagram”). The server re- 
sponds by also returning a single pack- 
et. In this protocol, the client must send 
the five-character string “Ping” (includ- 
ing the terminating NULL character). If 
the client sends the correct request, the 
server answers by returning another five- 
character string (“Pong”); otherwise, the 
error message “101 Invalid request” is re- 
turned. Granted, this is a bit contrived, 
but the general process is the basis for 
nearly all standard high-level, text-based 
Internet protocols. (Ping.h and related 
files are available electronically; see 
“Availability,” page 3.) 


Pools of Threads 

I've based my thread pool’s interface on 
Novell’s Asynchronous Event Services 
(AES) API. The AES API essentially con- 
tains the two functions in Example 3(a), 
with AESEVENT being defined as Exam- 
ple 30). 

In Novell’s implementation, the AES- 
EVENT structure passed to ScheduleAES- 
Event must be declared in a manner that 
assures its validity for the life of the event. 
This is because the data structure instance 
itself is linked (by way of the next field) 
into the system’s internal list of events 
waiting to be serviced, then passed to the 
event handler as event data. This may 
seem a bit odd, but the reasons for this 
sort of one-track, efficiency-minded atti- 
tude at Novell are historical in nature — 
and not necessarily bad—in most in- 
stances. There are significant advantages 
to passing the event’s AESEVENT data 
structure to the event handler. In the first 
place, nothing can go wrong with 
ScheduleAESEvent— thus, the void return 
value. It doesn’t even allocate memory. To 
pass private event data, you can allocate 
your structure instance larger and define 
your own data fields after the system-de- 
fined fields. 

Cancelling an event is simply a matter 
of passing the address of the same struc- 
ture instance to CancelAESEvent. If the 
event has not already been scheduled, 
and thus removed, from the waiting 
event list, it can be found and removed 
using the pointer address as a lookup 
field. If it has already been scheduled, 
then the allocated thread is already run- 
ning your handler, and must be termi- 
nated in a more proprietary manner. This 
is indicated by the return value of 
CancelAESEvent. 

My version of this interface encapsu- 
lates all of the necessary data for an en- 
tire thread pool in a C++ class called AES 
(see Listing Two). This class contains two 
private internal class definitions, one 
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xample 3: AES API functions. 


called PoolThread and the other, Event. 
PoolThread is used to manage a single 
pool thread, while Event is used to store 
event information for each scheduled 
event. Events are scheduled by the 
ScheduleEvent member function, which 
takes a delay time in seconds, a pointer 
to an event-handler function, and a 
generic pointer to data to be passed 
through to the event handler. It returns 
a handle to an event, which is imple- 
mented internally as a cast from the al- 
located data-block pointer. This handle 
may be passed to the CancelEvent mem- 
ber function. My version of Schedule- 
Event can fail in low-memory conditions. 
One of the main reasons I chose to im- 
plement this API as a C++ class is the 
freedom it allows users to reimplement 
internal functionality without noticeably 
affecting the interface. 


7 iN 


Listing Two shows my implementation 
of the AES class and, subsequently, its 
private classes. The pool monitor and 
pool thread-control functions are static 
members of the PoolThread and AES 
classes (respectively, Monitor and Work- 
er). Because they are static members, 
they have no implied this pointer. I solve 
this problem by passing the instance 
pointer as the thread data for each 
thread created. The pool monitor gets a 
pointer to the AES instance, while the 
pool thread gets a pointer to its 
PoolThread instance. 

The AES constructor takes a single pa- 
rameter— the number of threads to cre- 
ate on instantiation. This parameter de- 
faults to 8 if left unspecified. When an 
event is scheduled, a new event block is 
allocated, initialized, and inserted into 
the AES waiting list. Then the monitor 


\ 


semaphore is released and an event han- 
dle is returned to the client. Releasing 
the monitor semaphore wakes up the 
monitor thread, which rescans the list of 
waiting events for the nearest event due. 
If there are no events ready to be sched- 
uled, the monitor sleeps on its sema- 
phore for a time period calculated to 
wake it up when the closest event is due. 
If events are due, but no pool threads 
are available, a debug message is post- 
ed, indicating that the pool needs to be 
tuned, and the monitor sleeps until a 
new thread becomes available. Simply 
sleeping may seem inefficient for a low- 
thread scenario, but when tuned prop- 
erly, the pool will rarely run out of 
threads during a session. If it runs out 
too often, you need to increase the num- 
ber of threads in the pool for your ap- 
plication. 
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all integrating HyperHelp into Your Applications 





Calling WinHelp( ) From Your Application 
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More than Meets the Eye 

The uses of this AES-based implementation 
of a thread pool extend beyond those I’ve 
established here. This thread pool may also 
be used to schedule timed events. For ex- 
ample, Novell’s Service Advertising Proto- 
col (SAP) uses AES to broadcast a service- 
advertising packet every 60 seconds. Using 
class AES, the broadcast function can be 
written like Example 4. In this example, 
presumably there is a SAP class instance, 
which contains an AES instance member 
and whose pointer has been passed as 
event data to this event handler. The AES 
object might just as well have been de- 
clared as a static global, accessible to this 
handler by virtue of its definition in this 
module. 

There is a lot of room for improvement 
in this thread pool. The stack size might 
be an issue in your application, and thus 
become a tunable parameter to the AES 
class or the individual threads. The one 
problem this might present would show 
up during creation of the thread pool in 
the AES constructor. The pool is allocat- 
ed as an array of PoolThread objects. If 
you need to pass a stack-size parameter 
to the constructor for the PoolThread ob- 
jects, you will not be able to use array al- 
location. One solution to this limitation is 
to allocate raw memory for the thread- 
pool array using operator new, then use 
placement new to instantiate a PoolThread 
object for each block in the array. If you 
do this, you should call the destructors for 
each PoolThread directly, then deallocate 
the raw memory using operator delete. An- 
other possible feature that the pool could 
provide is thread-local storage on plat- 
forms that support it for maintaining 
thread-specific data. 

However you choose to implement a 
thread pool, it’s important to keep a few 
things in mind. First, this pool’s monitor 
thread does not poll the waiting list dur- 
ing idle time. Neither do the pool threads 
poll their respective event pointers. 
When not working, they are always 
sleeping on a semaphore. Virtually no 
CPU overhead is unnecessarily main- 
tained. The whole idea is to improve ef- 
ficiency. In the high-performance serv- 
er discussed earlier, it was critically 
important that the least amount of cy- 
cles be used between the current thread’s 
return from select and the next thread’s 
call to select. Wasting cycles during a call 
to ScheduleEvent defeats the purpose of 
the thread pool. For this reason alone, 
you might consider reimplementing the 
thread pool using Novell’s strategy of 
linking the event blocks right into the 
system’s waiting list. 


DDJ 
(Listings begin on page 86.) 
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f you close your eyes and have a friend 

walk around you snapping their fingers 

behind you, above you, or below you, 

you can pinpoint where the sound is 
coming from, even though your eyes are 
closed. Working together with your ears, 
your brain is able to determine where the 
sound is coming from because sounds 
phase shift and attenuate differently, de- 
pending on the location of the source. 

Three-dimensional sound attempts to 
synthesize this effect in software or hard- 
ware. This is analogous to a graphical ren- 
dering performed by 3-D graphics libraries. 

Intel’s Realistic Sound Experience (RSX) 
library was initially developed to enhance 
the silent 3-D world of VRML. (The VRML 
2.0-compliant RSX 2.0 SDK, which can be 
downloaded at http://developer.intel.com/ 
ial/rsx/, requires Windows 95/NT, a Pen- 
tium or 33/486DX, and stereo PC sound- 
card. MMX is not required, but it signifi- 
cantly enhances performance.) As the RSX 
project developed, however, it was ex- 
panded to support more demanding ap- 
plications of 3-D audio, such as 3-D 
games. These capabilities include HRTF- 
based (Head Related Transfer Function) 
localization, Doppler, reverberation, and 
real-time streaming. 

RSX uses a set of high-level COM-based 
interfaces for describing a 3-D audio world 
that follows a model similar to that used 
by high-level graphical rendering engines. 
A typical 3-D graphical application de- 
scribes a scene with objects and defines a 
view of the scene by specifying a camera. 
When components in the scene change, 
the application informs the rendering en- 
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gine, and the application renders a new 
image from the defined camera’s per- 
spective. 

Similarly, an application describes an 
audio scene with sound-source objects 
called “emitters” and defines an audio 
“point-of-view” by specifying a “listener.” 
When emitters change position or orien- 
tation, or when the listener moves, the ap- 
plication renders a new audio “view” from 
the listener's perspective. | 

Like graphical objects, you place and 
orient sounds in 3-D space. You can ad- 
just other properties, such as the defini- 
tion of ambient and directional sound re- 
gions to achieve the desired rendering 
effect. When you finish defining listeners 
and emitters, the RSX library can begin an 
audio rendering of the scene. For best re- 
sults, keep the audio environment con- 
sistent with the graphical environment. 
When objects move, both the graphical 
and audio rendering engines need up- 
dating. Likewise, when the view of the 
scene changes, the camera and listener 
positions need updating. 


Components of 3-D Sound 

Several components contribute to the ren- 
dering of 3-D sounds. “Spatialization” is 
the process of placing a sound in 3-D 
space. This is the audio counterpart to 
the position of an object, but rather than 
rendering with perspective and shading 
cues, audio is rendered such that sounds 
appear to originate from a specific loca- 
tion in space. RSX implements several lo- 
calization algorithms, the simple one be- 
ing a variation of left/right panning. The 
panning algorithm provides left and right 
placement of sound, but lacks what most 
would consider 3-D localization (the abil- 
ity to simulate left/right, up/down, and 
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front/back cues). To achieve true 3-D lo- 
calization, RSX uses an HRTF-based al- 
gorithm. 

“Reverberation” is an effect for simu- 
lating acoustic environments, ranging 
from small chambers to open canyons. 
This is the audio equivalent of environ- 
mental effects such as fog. Like fog ren- 
dering, reverberation has a global effect 
on the entire scene. The RSX reverbera- 
tor is based on the Schroeder reverb al- 
gorithm, which can simulate a wide range 
of acoustical environments. Some pa- 
rameters are user adjustable, such as in- 
tensity and delay. A minimal level of 
reverberation greatly improves the per- 
ceived spatialization. 

“Doppler” is used to simulate sounds in 
relative motion. The graphical counterpart 
to Doppler is motion blur. Rather than blur- 
ring an image, an audio signal is “blurred” 
through pitch shifting. As the velocity of 
the moving object dictates the degree of 
motion blur, so does it dictate the degree 
of pitch shifting. The classic experiment 
with Doppler involves a horn sounding 
on a moving train. As the train travels to- 
ward you, the sound waves are com- 
pressed, effectively increasing the pitch. 
As the train travels away from you, the 
sound waves are rarefied, corresponding- 
ly decreasing the pitch. 

“Pitch shifting” is commonly used to 
model engines, where the engine’s pitch 
is proportional to the engine RPM. Ex- 
plicit pitch adjustment is the equivalent 
of tweaking the color of light sources in 
the graphical world. The Doppler effect 
can be viewed as an automatic pitch 
shifter which translates the relative ve- 
locity between an emitter and the lis- 
tener. RSX implements two pitch- 
shifting algorithms, a low-quality/low-cost 
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(continued from page 60) 
drop-and-dupe algorithm and a high- 
quality/higher-cost pitch shifter without 
the artifacts of the low-cost implemen- 
tation. 


Sound Emitter Model 

RSX models an emitter in terms of two 
concentric elliptical regions. These two el- 
lipses describe an ambient region and an 
attenuation region. The shape of these el- 
lipses can be adjusted to vary the direc- 
tionality of the emitter. Figure 1 illustrates 
the elliptical sound model. 

The inner ellipse, identified by a mini- 
mum front range and minimum back 
range, defines an ambient region. The am- 
bient region maintains a constant, maxi- 
mum intensity relative to the given sound. 
The outer ellipse, identified by the maxi- 
mum front range and maximum back 
range, defines the attenuation region. With- 
in this region, audio is localized, and the 
intensity decreases logarithmically. Beyond 
the outer ellipse, the intensity is zero. 


Audio Streaming 

RSX provides interfaces to define two types 
of listeners and two types of emitters: di- 
rect and streaming listeners, and cached 
and streaming emitters. 

A direct listener lets RSX output sound 
to a standard audio interface. A streaming 
listener provides access to processed 
buffers from RSX. Both allow you to de- 
fine a listener and control its position and 
orientation in the audio environment. 

Cached emitters are file-based sound 
sources. Streaming emitters require buffers 
and let your application process real-time 
data. When you create an emitter, you as- 
sign it a specific sound, much as you 
would assign lighting and texture proper- 
ties to a polygon. You bring sounds to life 
by controlling when they start and stop 
and by adjusting their volume and tone. 





Figure 1: Sound emitter model. 
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Coordinate Systems and Units 
RSX supports both right- and left-handed 
coordinate systems. The application sim- 
ply informs RSX which format to use. The 
left-handed coordinate system can be pre- 
sented in the following orientation with re- 
spect to the display: the x—y plane is the 
screen, with x increasing to the right, y in- 
creasing upward, and z increasing into the 
screen. The right-handed coordinate sys- 
tem uses this same x—y orientation, but 
specifies z increasing away from the screen. 
RSX defines all of its audio using an ab- 
solute coordinate system, known as “world” 
or “scene” coordinates to many graphics li- 
braries. There is no support for specifying 
the position or orientation of one object rel- 
ative to another object. When working with 
high-level graphics libraries, coordinates 
passed to RSX should be in either world or 
scene coordinates. That is, you must spec- 
ify an audio object’s x-,y, and z-coordinates. 
RSX calculates the relative relationship 
between objects, their position and at- 
tributes, and uses this information for ren- 
dering. In this model, distance has no units. 
RSX uses the speed of sound for Doppler 
effects, and all time is specified in seconds. 
You must supply the value for the Doppler 
effect in generic units per second. 


COM Interfaces 

The RSX library consists of five COM in- 
terfaces and two abstract base classes. The 
abstract base classes group together the 
methods that are common to all emitters 
or all listeners. The emitters or listeners 
provide the abstract base class functional- 
ity through their respective interfaces. Table 
1 lists the RSX interfaces. 


WaveSpinner Application 

While working on the RSX library, I often 
found myself creating example .WAV files 
that were spatialized in different ways to 
demonstrate different effects. I grew tired 





of trying to slap together an application 
just to move the sounds around. I decid- 
ed to write a tool that would accept a script 
that described the movement and charac- 
teristics of sounds in a 3-D world. The tool, 
called “WaveSpinner,” reads such a script, 
animates and spatializes all the sounds us- 
ing RSX, and writes the result to a .WAV 
file. This tool is very useful for creating 
static sequences such as background noise, 
missile fly-bys, and other sounds that need 
to be spatialized, but will not change. The 
missile fly-by, for example, can be used 
many times in the course of a game, but 
will require minimal CPU time, as it does 
not need to be spatialized at run time. (The 
complete source code and related files for 
WaveSpinner are available electronically; 
see “Availability,” page 3.) 


Example Script 

Listing One (listings begin on page 89) is a 
WaveSpinner script that animates some WAV 
files commonly found in the Windows 95 
C:\Windows \Media directory. You already 
have these input files available if you have 
a default install of Windows 95. 

To simplify parsing of the script file, I 
adopted a pseudo-Visual Basic scripting 
syntax. There are four types of objects: lis- 
tener, environment, output (which are pre- 
declared), and emitter (which you declare 
in the script). There can be any number 
of emitters and only one instance of each 
of the other objects. For each object, you 
can set certain variables or call a method. 
Variables are set with an equal sign, and 
these settings hold throughout the entire 
processing cycle; if you try to set a vari- 
able twice, the last setting is used. Meth- 
ods, of course, can be called as many times 
as necessary. The methods closely reflect 
the actual RSX API, except that they have 
an additional first parameter that specifies 
time. This time parameter adds the ani- 
mation element to the generated .WAV file. 
For example, if you specify Listing Two, 
WaveSpinner will smoothly move the 
sound from the first position to the sec- 
ond in three seconds. The granularity of 
time is 40 milliseconds, which is about the 
smallest practical time interval because RSX 
needs sufficient buffer length to “smooth” 
one buffer into the next. If the buffer size 
is too small, the buffers cannot be blend- 
ed sufficiently, and the result is unwanted 
pops and clicks in the output. 

A script file will usually declare the out- 
put settings up front, although they can 
be anywhere in the file since WaveSpin- 
ner collects all settings before generating 
output. In the example, I create a 30- 
second .WAV file and write it to c:\nois- 
es.wav, with the output spatialized for 
headphones. 

One of the output settings is Peripheral- 
Type. The possible values for this setting 
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On average, there are 1.2 defects] in every 200 
lines of code. That is about 12,000 hours -or 5.7 
man years!- to debug a program of 200,000 lines of 
code, costing an estimated half-a-million dollar! The 
more bugs left undetected by your tool, the more 
time you will spend finding bugs manually (Le. 
slowly). You depend on your automatic error detec- 
tion tools to work the way they are meant to- detect- 
ing bugs and detecting them automatialh 


You expect your tools to work-to improve 
and to speed up your development process. 
Unfortunately not all tools live up to their 
claims; some even slow down your develop- 
ment process! Many tools claim their efficien- 
cy and effectiveness. Let me fill you in on a 
secret - they are not as effective oras efficient 
as they clam. Some of these tools don’t go 
straight to your source code to debug. Instead, 
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(continued from page 68) 

are Headphones, Speakers, and Transaural. 
It is important to know what the output 
type is because the HRTFs and postpro- 
cessing of the .WAV file change depending 
on the type. If the peripheral type is set to 
Speakers, then the sound is not spatialized 
using HRTFs, but Doppler, reverb, and at- 
tenuation effects still apply. If the output 
type is Headphones, then HRTFs are used. 
If the peripheral type is Transaural, then 
HRTFs will be applied and the output will 
be fed through a cross-canceling filter, 
which is the necessary adjustment to get 
the 3-D effect from two open speakers. 

Listing Three summarizes the script- 
ing API. The README.TXT file included 
with WaveSpinner describes the meth- 
ods in greater detail, and shows an ex- 
ample of each. 

For the environment object, you can set 
the reverb volume and the speed of sound 
(which effects Doppler). The listener meth- 
ods allow you to position and orient the lis- 
tener. Emitters are declared by specifying 
the source file; for example, emitter MyEmit- 
ter1=c:\tidal.wav. This emitter can then be 
used in the script. Order of statements in 
the file is unimportant except in two cases: 
setting a parameter twice, in which case the 
second setting will be used; and two state- 
ments falling inside a 40-ms time period, in 
which case both will be called Gn order). 


Code Overview 
WaveSpinner uses three main classes: 
CEmitterObject, CListenerObject, and CEn- 
vironObject. There probably should be 
an Output class as well, and to its nonex- 
istence I can plead no excuse other than 
laziness and the fact that this code has 
changed several times before settling into 
its present form. Anyhow, the existing 
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Table 1: RSX interfaces. 
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classes wrap the actual RSX interfaces, 
and incorporate additional methods to 
parse commands from the input script 
file and to animate the sounds as time 
marches on. 

WaveSpinner makes an initial pass 
through the script file to gather the output 
settings and build a linked list of declared 
emitters. It then runs a second pass for en- 
vironment, listener, and emitter statements. 

To parse the script file, the main pars- 
ing loop reads a line from the script file, 
determines who the line belongs to, and 
then asks the owner to parse the line them- 
selves. For example, if an incoming line 
starts with “listener.Position(...)”, the lis- 
tener object will be handed the line using 
the CListenerObject::ParseCcommand() 
method. If the listener has a problem pars- 
ing it, it merely returns false, the line is sent 
as an error to the Wave Spinner main win- 
dow, and the line is ignored. 

Likewise, statements prefixed with “en- 















an emitter (determined by looking 
through a COblList of emitter objects) are 
passed to the ParseCommand() method 
of the correct object instance. Internally, 
the objects examine the information and 
construct lists (using the CKey objects de- 
scribed later) or tables (for calculating 
splines). 

After the file parsing, WaveSpinner ad- 
justs the RSX peripheral type. RSX relies 
on a registry setting to know what the pe- 
ripheral type is. To actually adjust the RSX 
setting, WaveSpinner stores the old setting 
from the registry, writes the new value, 
runs the script, and then switches back to 
the old setting. 

WaveSpinner then enters the main play 
loop. During each iteration of the play loop, 
WaveSpinner calls the SetTime() method 
of each object. In response to SetTime(), 
each object refers to its internal keys or ta- 
bles and makes any changes necessary to 
the underlying RSX object. Once all the ob- 
jects have been correctly updated, 
WaveSpinner requests a buffer from the 
RSX streaming listener. Inside in RSX, the 
streaming listener gets its input data from 
the RSX emitters and generates an output 
buffer. WaveSpinner then takes the buffer 
and writes it to the output . WAV file. 

The play loop then repeats, incrementing 
the time by 40 ms each iteration. The loop 
stops when the time exceeds output.To- 
talPlayTime. WaveSpinner then deletes all 
RSX objects, closes the output file, and re- 
stores the peripheral setting in the registry. 


Keys versus Splines 

The listener and emitter classes both use 
CKey and CSplineArray objects. The envi- 
ronment object uses only CKey objects. 
While the script is running, there are two 
types of settings that will be adjusted while 
time marches on— those that need to be 
interpolated and those that don’t. The only 
things that need to be interpolated are po- 
sition and orientation. Other settings, such 
as emitter model and reverb can change 
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abruptly without adverse effect and there- 
fore do not need to be interpolated. 

Keys are used to perform the correct ac- 
tion at a specific time. Each key only 
knows how to do one thing —Run()— 
and each has an m_ Time associated with 
it. The idea is that a large collection of 
them can be hung in a linked list, then it- 
erated through and executed at the prop- 
er time. When WaveSpinner calls SetTime() 
on the emitter object, for example, the 
emitter walks through its linked list of keys 
and calls Run() on every key whose 
m_f Time value is between the previous 
time and the current time. 

I use the CSplineArray class to handle 
interpolation. To refresh your memory, 
spline is an algorithm that allows you to 
smoothly interpolate a curve between a set 
of points. The CSplineArray class encapsu- 
lates a one-dimensional spline, and you can 
combine these to handle splines of higher 
dimensions. I have thoughtfully provided a 
3D§Spline class that contains — you guessed 
it— three instances of the CSplineArray 
class. The 3-D spline is used for position 
and orientation of emitters. Orientation of 
the listener uses a 6-D spline set, since a 
listener requires a 3-D up direction as well 
as a 3-D forward direction in order to ful- 
ly specify orientation. Combining the di- 
mensions this way is possible because you 


can interpolate a point in n-dimensional 
space by interpolating each of the dimen- 
sions independently (I don’t know if this is 
a theoretically correct statement, but it does 
seem to work in practice). 

I appropriated (stole) the spline algorithm 
from Numerical Recipes in C, Second Edi- 
tion, by William H. Press and others (Cam- 
bridge University Press, 1996). I chose this 


Doppler is used to 
simulate sounds in 
relative motion 





implementation because it is a 2-D spline, 
as I will be feeding it several 2-element val- 
ues, namely time and a value. Because the 
times will not be on nice integer bound- 
aries, I needed a spline that could handle 
several widely scattered points. For exam- 
ple, the user may give me points like (0.0, 
2.0), (0.25, 1.0), and (3.75, 0.0). With the 
spline algorithm I chose, I can hand in an 
arbitrary time and it will magically figure 
out what the output value should be. 





Upon examining the spline code, you 
will see that it closely follows the code in 
the book. I have added code to handle 
some special cases and boundary condi- 
tions. Note that before the spline can be 
used, some tables need to be set up that 
contain all the input points. The infor- 
mation for these tables was gleaned from 
the information passed in through the 
ParseCcommand() method. 


Final Notes 

Note that to build WaveSpinner, you need 
to have RSX installed (available at http:// 
www. intel.com/ial/rsx/). A good addition 
to WaveSpinner would be a GUI interface 
that lets you drag and drop sounds into po- 
sition and plot their animation sequence. 
Writing the script by hand is quicker than 
writing a program to animate the sounds, 
but still becomes tedious. Another en- 
hancement would be to add animation 
loops. Currently, if you want a sound to 
rotate every five seconds for a period of 
30 seconds, for example, you would need 
to repeat the orientation sequence six 
times in the script. It would be easier to 
enter it once and have WaveSpinner take 
care of the rest. 


DDJ 
(Listings begin on page 89.) 
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rowsers such as Netscape’s Naviga- 
tor or Microsoft’s Internet Explorer 
use a text-based “document” meta- 
phor to interface computers and the 
Internet. An alternative metaphor is to pro- 
vide 3-D virtual worlds that let you con- 
duct experiments in virtual laboratories, 
see how to replace a virtual part from the 
same vantage point a real part would have 
to be replaced, plan itineraries by previs- 
iting 3-D virtual destinations before actu- 
ally embarking on journeys, and more. 

The Tecate system provides an infras- 
tructure in which application-specific 
browsers can be quickly crafted to meet the 
demands of end users. Tecate provides a 
set of tools for describing animated 3-D 
scenes and their interaction with end users, 
which enables the description of interfaces 
to existing applications and data sources 
such as the World Wide Web, enables re- 
mote collaboration, and fosters software 
reuse through object orientation. Tecate’s 
networking capabilities allow these worlds 
to interface with the Web, external databas- 
es, other worlds, and existing applications. 
The modular, object-oriented nature of 
Tecate worlds allows their components to 
be reused. 

Tecate is publicly available at ftp:// 
ftp.sdsc.edu/pub/sdsc/graphics/tecate/ 
tecate.tar.gz. It runs on most UNIX plat- 
forms that support OpenGL 3-D. The Mesa 
OpenGL emulation library can be used for 
those systems that don’t have OpenGL sup- 
port. Tecate has been successfully installed 
on Digital Alpha and SGI Irix systems. 





Tecate and Other Technologies 

Tecate is not a browser— it is a collection 
of powerful components that can be 
combined to create application-specific 
browsers. Traditional browsers are really 


Peter, a software engineer with Digital 
Equipment Corp. is in residence at the San 
Diego Supercomputer Center. He can be 
contacted at kochevar@sdsc.edu. 


72 


Tecate and 
Interactive 3-D 


Combining networking and 3-D objects 


Peter D. Kochevar 


“black boxes” that offer limited cus- 
tomization through the setting of parame- 
ters. (One exception to this architecture is 
Sun’s HotJava browser, which adopted a 
component architecture similar to Tecate.) 

Tecate uses virtual worlds as an under- 
lying browsing metaphor instead of docu- 
ments. A Tecate world can share informa- 
tion with other remote worlds. That is, a 
single world can be built in which multiple 
users can enter and independently navigate. 
This is something that is just beginning to 
appear in products such as Black Sun’s Cy- 
berHub, a VRML-based multiuser server. 
The Tecate MOO example demonstrates 
this capability. 

Tecate’s API is the Abstract Visualiza- 
tion Language (AVL), a typeless script- 
ing language based on Tcl. AVL extends 
Tcl by adding object-oriented program- 
ming support, 3-D animation, and a so- 
phisticated event-handling mechanism. 
The growing use of scripting languages 
such as AVL is evidenced by the recent 
proliferation of JavaScript, VRMLscript, 
NeXT’s WebScript, VBScript, and the 
like. AVL differs from many of these lan- 
guages in that it has 3-D graphics in- 
corporated within it, something that is 
just beginning to happen with the oth- 
er languages. If interpreted AVL is too 
slow, Tecate allows time-critical behav- 
ior to be implemented in a compilable 
language such as C or C++. 

AVL has taken a different approach than 
other 3-D graphics languages. In VRML, for 
instance, the stress is on creating 3-D graph- 
ics and not on specifying the behaviors of 
objects. VRML’s behavior system is loosely 
coupled to a graphics system based on 
OpenInventor. In AVL, graphics and be- 
haviors are more tightly coupled. AVL stress- 
es object- object interactions, with graphics 
appearing as a side effect. In general, VRML 
is still rooted in classical computer graph- 
ics methodology— the hierarchical scene 
graph—while AVL takes a more modern, 
object-oriented approach. 


Although both Tecate and VRML sup- 
port interactive 3-D graphics, the two sys- 
tems are very different. VRML uses a tra- 
ditional “scene graph” to define the 
graphics, with behavior defined separate- 
ly. Tecate provides a modern, object-ori- 
ented environment in which the graphics 
are a side effect of object-object interac- 
tions. Tecate’s full-featured programming 
language supports networking and 
database queries, making it easier to dy- 
namically access and visualize informa- 
tion from within Tecate worlds than from 
within their VRML counterparts. 


Tecate’s Architecture 

Tecate is comprised of a run-time system 
and API (see Figure 1). The run-time sys- 
tem is an extensible, object-oriented sys- 
tem whose major components are objects 
as well as entities that appear within in- 
teractive virtual worlds. All objects pos- 
sess four classes of properties: 


e Appearance. Attributes that affect an ob- 
ject’s visual appearance such as geo- 
metric and topological structure, color, 
texture, material properties, and so on. 

e Behaviors. A set of procedures invoked 
upon receipt of messages from other 
objects. 

e State. A collection of variables whose 
values represent an object’s state. 

e Subobjects. A list of objects that are parts 
of a given object, just as a wheel is a 
part of a car. 


-Tecate’s run-time system has a layered 
architecture consisting of a kernel, a com- 
plement of system services, and a toolkit 
of visualization and user-interface com- 
ponents (see Figure 2). The kernel con- 
sists of the Object Manager, the Rendering 
Engine, and the Communications Stub. 
The Object Manager manages the creation, 
deletion, modification, and communica- 
tion of objects. The Rendering Engine is 
responsible for creating visual and aural 
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(continued from page 72) 

renditions of virtual worlds that represent 
data. The Communications Stub provides 
the means for multiple Tecate sessions to 
run simultaneously while sharing a single 
virtual environment, thus fostering col- 
laboration among end users. 

Tecate’s system services consist of in- 
terfaces to the Web and to databases man- 
aged by the Illustra database management 
system. The web interface allows any 
Tecate object to specify a URL from which 
information is to be drawn, and then 
mapped into an appropriate virtual world 
(Figure 3). The database interface func- 
tions similarly except that Tecate objects 
can pose queries written in SQL and the 
query results are then mapped into an an- 
imated, 3-D scene that represents the in- 
formational content of the queried data 
(Figure 4). 

You can add new system services to 
Tecate by providing a set of functions that 
can be invoked by other Tecate objects. 
These functions correspond to the be- 
haviors that are called when the service 
receives a message from other objects. 
Tools are provided to register the behav- 


Figure 1: The Tecate system and its 
relationship to application programs. 








iors with Tecate and to manage the com- 
munication between the object providing 
the service and other Tecate objects. 

Tecate’s toolkit is a set of predefined 
objects that can be used for developing 
applications. The toolkit contains windows, 
lights, and cameras used to illuminate and 
render virtual worlds on a computer dis- 
play. The toolkit also contains a collection 
of 3-D UI widgets— sliders, menus, icons, 
legends, coordinate axes, and the like— 
that can be used within virtual worlds. Fi- 
nally, the toolkit contains a clock that is 
used to pace animations and trigger events. 
As with the system services, Tecate’s base 
toolkit can be augmented by application 
programmers. 


Describing 3-D Animation 

AVL applications are descriptions of active 
objects. Tecate focuses on creating these 
objects and defining how they interact with 
one another over time. Although these ob- 
jects can have geometry and appearance 
properties, the handling of graphics is not 
a primary concern of Tecate. Rather, 3-D 
animation is a side effect of general ob- 
ject-to- object interactions. 

A collection of objects defined within 
Tecate constitutes a virtual world. Objects 
in a virtual world are “active” because each 
object functions independently from other 
objects under a separate thread of control. 
Objects interact with one another by pass- 
ing messages between them. When objects 
receive messages, handlers are invoked to 
respond to the messages. These handlers 
are methods, called “behaviors,” that are 
encapsulated within the objects. Within be- 
haviors, objects can send new messages to 
other objects; create new objects or destroy 
old ones; and objects can alter the state, 
appearance, behavior, and subobject prop- 
erties of either themselves or other exist- 
ing objects. 

Once all of the objects have been de- 
fined, a virtual world is set in motion by 





Figure 2: Detail of Tecate’s kernel along with the system services provided by Tecate. 
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sending messages to those objects. These 
objects process the messages, usually re- 
sulting in a new set of messages being 
sent to yet other objects and so on. Often 
messages are sent to specific objects by 
users via input devices such as a mouse 
or keyboard. In Tecate, input devices are 
objects that send messages to other ob- 
jects whenever input is provided. Objects 
wishing to be informed of input events 
register themselves with the associated in- 
put device objects. 

Not all input devices trigger solely upon 
direct user interaction. For instance, with- 
in Tecate, clocks can be set under program 
control. At every clock tick, all objects that 
have registered with a clock are sent a mes- 
sage informing objects of the tick. These 
clocks can be used to time events or trig- 
ger actions. More importantly, the clocks 
are used to pace animations, allowing ob- 
jects to periodically update their state and 
appearance. 

Aside from object- object relationships 
via inheritance, AVL also supports object- 
subobject relationships, which bind one 
object to another. Currently, there are two 
types of constraints supported within 
Tecate: 


e Logical Constraint. An object is logical- 
ly bound to another; there is no formal 
geometric relationship between the two 
objects. Logical constraints are useful 
for creating sets of objects. 
Transformational Constraint. One object 
is constrained positionally, orientational- 
ly, and/or size-wise to another object. 
Transformational constraints are used for 
positioning objects in a scene and for 
creating part/subpart relationships. Note 
that for an object to appear within a 
scene, it must be transformationally con- 
strained to the scene object or to some 
object that can trace transformational con- 
straints through part/subpart relationships 
all the way to the scene object. 


An object can be logically constrained 
to any number of objects while at the 
same time being transformationally con- 
strained to at most one other object. Also, 
an object can have any number of sub- 
objects of either constraint type provided 
that all the subobjects are distinct. 

In Tecate, there is a single object- 
creation operation called “cloning,” and any 
object in the system can serve as a proto- 
type from which a copy can be made 
through the clone operation. A clone inherits 
properties by maintaining a link to its pro- 
totype. When a reference to a property is 
made within an object, the system looks 
for the property value locally within the ob- 
ject. If no property value is found, then the 
object’s prototype is searched in order to 
associate a value with the reference. If 
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the prototype is itself a clone from some 
other object, then the prototype’s proto- 
type is recursively searched to resolve 
the reference. This type of “lazy” evalu- 
ation of property references is known as 
“delegation.” 

Note that subobject relationships are 
not inherited, that is, Tecate only does 
shallow cloning. Deep cloning, in which 
the subobjects are recursively cloned, must 
be done programatically within AVL. Sub- 
object properties are not “intrinsic prop- 
erties” of an object, as are state variables, 
appearance attributes, and behaviors. Only 
intrinsic properties are inherited. 

With Tecate’s delegation model, a 
change in a property value can affect all 
other objects cloned from the original ob- 
ject. This type of semantics is useful for 
establishing class-instance-like relation- 
ships between objects. For instance, one 
object may represent a particular class of 
automobile tire while all clones of the ob- 
ject would represent class instances. If a 
class-level change is needed that affects 
all instances (for example, a new tread 
pattern is to be introduced), only the ob- 
ject representing the tire class needs to 
change rather than having to change all 
instances individually. 

The clone-prototype chaining implied 
by delegation can be overridden by chang- 
ing the property values locally. For exam- 
ple, if one particular tire instance is to have 
a new tread pattern, then the pattern is al- 
tered in that instance only. References to 
the tread pattern for that object will use 
the local tread value rather than chain back 
to the tire class object. All other instances 
will continue to reference the value pre- 
sent in the tire class object. 

Since AVL is a superset of Tcl, AVL pos- 
sesses the standard program-control con- 
structs such as if-then-else, switch, for- 
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This copy interacts with its counterparts 


age created using Tecate. 


loops, and so on. In addition, AVL has a 
rich set of list and string manipulation 
commands that it inherits from Tcl. 

AVL adds several additional commands 
to the standard Tcl instruction set. The 
clone command is the object-creation 
command within AVL, and the delete com- 
mand is the complementary operation to 
delete objects from the system. Object 
properties are specified and manipulated 
using the add command and deleted us- 
ing the remove command. Behaviors in 
one object are initiated by another object 
using the send command, which specifies 
the behavior to invoke and the arguments 
to be passed. Queries about object prop- 
erties can be made using the inquire com- 
mand. The which command is used to de- 
termine where an object’s properties are 
actually defined in light of Tecate’s use of 
delegation to resolve property references. 
Finally, AVL provides a rich set of matrix 
and vector operators that are useful when 
positioning objects within 3-D scenes. 


A 3-D MOO Example 

To illustrate some of the capabilities of 
Tecate, I'll use AVL to build a framework 
for a 3-D Multi-User Dungeon Object- 
Oriented (MOO). A MOO is a shared vir- 
tual world that individuals can enter and 
act within, independent of other users. Pri- 
or to entering a shared world, each user 
defines an avatar— a 3-D model that will 
represent his or her presence in the world. 
As users move about the world, their 
avatars also move, allowing others to see 
who is present in the world and what they 
are looking at. 

A 3-D MOO framework can be imple- 
mented as an AVL program. A copy of this 
program is run on each user’s computer, 
creating a local copy of the shared world. 


tee 





eer FUEL! eae 





to ensure that the copies remain consis- 
tent over time. 

The program also allows users to enter 
and leave the shared world. When new 
users enter a world, their copies of the pro- 
gram request a snapshot of the world’s cur- 
rent state from some other copy. The new 
user’s program then builds its local copy of 
the world based on the information that it 
is sent. In addition, the presence of new 
users is broadcast to all others in the MOO, 
so that their programs can begin sending 
updates to new users. 

In the program, the object named moo 
(see Listing One, listings begin on page 
90) is responsible for creating the local 
copy of the shared world and for main- 
taining state consistency. To simplify the 
example, the specification of the shared 
world is hardwired into the program. Fur- 
thermore, I assume that the shared world 
does not change over time save for the 
movement of participants’ avatars. There- 
fore, the state of the MOO at a particular 
time can be described simply by listing 
the position and orientation of each avatar. 

The moo object is cloned from the World- 
Viewer object, part of Tecate’s basic toolkit. 
WorldViewer manages the display of the 
MOO world, and it provides a participant 
with helicopter-like flight controls for nav- 
igating the world. WorldViewer is an “ab- 
stract” object; it is not intended to be used 
directly but rather serves as a template from 
which other objects can be cloned. 

To join a MOO session, new users send 
a bootstrap message to the moo object on 
their local host computer. The name of a 
remote host computer that is already run- 
ning is passed as an argument, as is a spec- 
ification of the shape of the avatar new users 
wish to assume. The moo object on the re- 
mote host is then informed that a new user 
wishes to join the MOO via the enter mes- 
sage. The remote host’s moo object re- 
sponds by sending the new user’s local moo 
object the current state of the MOO using 
the startUp message. The remote host’s moo 
object also informs all current MOO partic- 
ipants that new users are joining the session 
by broadcasting a newPlayer message. Note 
that in AVL, the send command can be used 


Figure 4: A visualization of data 
accessed via Tecate’ database interface. 
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(continued from page 70) 
to send a message to an object residing on 
a remote machine by prepending a host 
name to the name of the object that is to 
receive the message. 

For simplicity, the name of a distin- 
guished host computer is hardwired into 
the single program that all MOO partici- 
pants run. That host must be the first to 
run the program, thus providing all oth- 
er participants’ programs with a source for 
acquiring the current state of the MOO. 

The move behavior in moo (inherited 
from WorldViewer) is responsible for al- 
tering a user’s position within the shared 
world of the MOO. This behavior is linked 
automatically to certain mouse and key- 
board events when the init message that 
is inherited from WorldViewer is sent to 
the moo object. To the default move be- 
havior, moo adds a broadcast of a user’s 
position and orientation to all other MOO 
participants. 

In this example, the shared world of 
the MOO consists of a collection of rooms. 
Each room is a clone of the Room abstract 
prototype object; see Listing Two. Unlike 
rooms in a building, the rooms within the 
implemented MOO are not spatially adja- 
cent to one another. Instead, each room 
serves as a Virtual world unto itself. At any 
given time, a user is located in a single 
room, and since all rooms in the MOO 
have no windows, a user can only see the 
contents of the room in which he or she 
currently resides. Therefore, only one 
room needs to be displayed at any given 
time. When users are in a room, that room 
is considered to be “realized,” and all oth- 
er rooms are “unrealized.” 

MOO participants can move from one 
room to another by crossing a “bridge.” 
A bridge consists of two “portals,” each 
of which appears as a disk in the rooms 
spanned by the bridge. Figure 5 is a typ- 
ical room in the MOO containing a few 
portals, and two avatars signifying the 
presence of other users in the room. List- 
ing Three presents code for the Bridge ab- 
stract prototype object (code for a Portal 
abstract prototype object is available elec- 
tronically; see “Availability,” page 3). 


Figure 5: A user's view of a room 
within a MOO. Disks represent portals. 
The two other objects are avatars. 
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To travel from one room to another (a 
process called “wormholing”), a MOO par- 
ticipant can perform one of two actions— 
fly into a disk representing a portal, or se- 
lect a disk with the mouse and be drawn 
automatically into a portal. Both mechanisms 
rely on the proximity behavior within a Por- 
tal object. If a user moves within a certain 
predefined distance from the center of a 
portal, the user is then wormholed into an- 
other room by the wormhole behavior of 
Portal. 

Proximity testing is performed each time 
users move within a realized room. In the 
body of the init behavior, portal objects no- 
tify the room objects in which they reside 
that they wish to be informed of “realize” 
events. Then, when a room is first redis- 
played, a portal’s enableProximity behav- 
ior is invoked. This behavior registers with 
the viewer object that a portal is to be in- 
formed of “move” events. When so regis- 
tered, user movement automatically causes 
a portal’s proximity behavior to be invoked. 

When users pick a disk representing a 
portal, they are automatically flown into the 
portal. The process by which this happens 
illustrates how animation occurs within 
Tecate: Objects wishing to animate inform a 
clock object that they want to receive clock 
tick events. In the MOO program, a mouse 
click on a portal causes the portal to regis- 
ter itself with the predefined clock object 
called SystemClock. At each clock pulse, a 
portal’s tractor method is called, which moves 
the user a tenth of the distance from their 
current position to the center of the portal. 

Listing Four (available electronically) is the 
code segment where the MOO’s shared 
world is defined, and all object initializations 
take place. The shared world consists of 
three rooms: a, b, and c. Bridges are creat- 
ed to allow users to wormhole from any 
room to any other room. Users are initially 
placed into room a when they first enter the 
shared world of the MOO. The name of a 
currently running host and a user’s avatar 
shape description are assumed to be defined 
in the AVL variables bootstrapHost and shape, 
respectively. If the program is run on the 
host named in bootstrapHost, then the moo 
object there allows the user to move about 
the three-room world while waiting for en- 
try requests from other users at remote sites. 
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IMPLICIT SURFACES 


Listing One 


LSurface Components; // Given Instance in Object Database 
// Pre-Allocated Temporaries for Calculations 
static float xl, yl, z1, x2, y2, z2, Tmpi, Tmp2, Tmp3, Tmp4, Tmp5, Tmp6, 
Tmp7, Tmp8, Tmp9; 
aa LSurface: :MGSM(float x, float y, float z) 
// Initialization of Threshold and Number of Components 
float Total=Components.GetThreshold() ; 
int N=Components.GetSize(); 
// Loop through all components 
while(N-) { 
Ci=&Components[N]; // Get Pointer to Current Component 
// Check For Any Angular Rotation 
if( !((Ci->Theta_X==@) && (Ci->Theta_Y==0) && (Ci->Theta_Z==9) )) 


{ 
// There is Angular Rotation So Use Angular Model 


// Perform Translation of Component 
Tmp1=x+Ci->Tx; 
Tmp2=ytCi->Ty; 
Tmp3=z+Ci->Tz; 

// Calculate Temporaries for Rotation 
Tmp4=Tmp2*Ci->cos_z; 
Tmp5=Tmp1*Ci->sin_z; 
Tmp6=Ci->cos_z*Tmp1; 
Tmp7=Ci->sin_z*Tmp2; 
Tmp8=Ci->cos_y*Tmp3; 


// Perform Rotation 

x1=(Ci->cos_y* (Tmp6-Tmp7)+Ci->sin_y*Tmp3) ; 

y1=(Ci->sin_x*(Ci->sin_y*Tmp6- Ci->sin_y*Tmp7-Tmp8) 
+ Ci->cos_x*(Tmp5+Tmp4) ) ; 

z1=(Ci->cos_x* (-Ci->sin_y*Tmp6+Ci->sin_y*Tmp7+Tmp8) 
+ Ci->sin_x*(Tmp5+Tmp4) ) ; 

// Perform Stretching 

x2=x1*Ci->Sx; 

y2=y1*Ci->Sy; 

Z2=z1*CI->Sz; 

// Calculate Divisor 

Tmp9=(x2*x2+y2*y2+z2*z2) ; 

Total-=( Ci->Strength / (Tmp9< 9.000001? 0.000001 : Tmp9));: 

J 

else { 
// There is No Angular Rotation (x1), So Use Simple Form 


// Translate and Stretch at the Same Time 
X2=(x+Ci->Tx) *Ci->Sx; 
y2=(y+Ci->Ty) *Ci->Sy; 
y2=(zt+Ci->Tz) *Ci->Sz; 


// Calculate Divisor 
Tmp9=(x2*x2+y2*y2+z2*z2) ; 


// Apply to Threshold 

Total-=(Ci->Strength / (Tmp9< 0.900001? 9.000001 : Tmp9)); 
le 

}: 


return Total; 


} 
IMAGE PROCESSING 


Listing One 


#include <SGIReader.h> 
#include <Contraster.h> 


#include <SGIWriter.h> 
int main ( int argc, char *argv[] ) 


SGIReader in( “test.rgb” ); 
Contraster contrasted( &in, 1.3 ); 
SGIWriter 
out( “out.rgb”, (InputImage *)&contrasted, in.getArea(), UChar) ; 
return ( @ ); 


e e 
Listing Two 
// File: Contraster.h -- (c) 1996 Mayur Patel 


#ifndef Contraster_CLASS 
#define Contraster_CLASS 


#include <InputImage.h> 
finclude <Type.h> 
class Contraster : public InputImage { 
public: 
Contraster( InputImage *pIn, float rLumFactor, float rGreyPoint = 9.5 ); 
~Contraster( void ); 


int 
fillTile( ImageTile *pWriteHere ); 
protected: 
InputImage *_pHost; 
float _rLumFactor; 
float _rGrey; 
}; 
#endif 


Dr. Dobb’s Journal, July 1997 


J ® 
Listing Three 
// File: Contraster.C -- (c) 1996 Mayur Patel 


#include <Contraster.h> 
#include <assert.h> 


Contraster::Contraster( InputImage *pIn, float rLumFactor, float rGrey ) 
: InputImage( Real ) 
{ 


_pHost = pin; 
if ( _pHost ) 
_pHost->registerReference() ; 
_rLumFactor = rLumFactor; 
_rGrey = rGrey; 
} 
Contraster::~Contraster( void ) 
{ 
if ( _pHost ) 
_pHost->unregisterReference() ; 
return; 
} 
int 
Contraster::fillTile( ImageTile *pWriteHere ) 
{ 
int iRet = 9; 
ImageTile *pTile; 
unsigned long lLoop; 
register float *pSrc; 
register float *pDest; 
if ( _pHost && pWriteHere ) 
{ 
pTile = _pHost->newTile( pWriteHere->getArea() ); 
if ( pTile ) 
{ 
assert( getType() == pWriteHere->getType() ); 
pTile->typecast( Real ); 
pSre = (float *) pTile->getBuffer () ; 
pDest = (float *) pWriteHere->getBuffer () ; 
lLoop = 
pWriteHere->getArea().width * 
pWriteHere->getArea() .height; 
while ( lLoop ) 
{ 
lLoop--; 
// contrast enhance: 
*pDest = _rGrey + (( *pSre - _rGrey ) * _rLumFactor ); 
// clamp over-exposure & under-exposure: 
*pDest = ( *pDest < 0.0) ? (0.0) : ( *pDest ); 
*pDest = ( *pDest > 1.0) ? (1.0) : ( *pDest ); 
pDesttt; 
pSrcett; 
} 
pTile->deleteTile(); 
} 
} 
return ( iRet ); 


} 


Listing Four 


#ifndef TYPESEPER 
#define TYPESEPER ; 
#endif 


#ifndef TYPEENDOFLIST 
#define TYPEENDOFLIST ; 
#endif 


TYPEMACRO( float, Float ) 
TYPESEPER 

TYPEMACRO( int, Int ) 
TYPEENDOFLIST 


#ifdef TYPESEPER 
#undef TYPESEPER 
#endif 


#ifdef TYPEENDOFLIST 
#undef TYPEENDOFLIST 
#endif 


#ifdef TYPEMACRO 
#undef TYPEMACRO 
#endif 


Listing Five 
enum Type ( 


#define TYPESEPER , 

#define TYPEENDOFLIST 

#define TYPEMACRO( type, label ) label 
#include <Type.m> 

hs 


e e e 
Listing Six 
void 
addition( Type opType, void *pDest, void *pOpi, void *pOp2 ) 
{ 
switch( opType ) 
{ 
#define TYPEMACRO( type, label ) \ 
case( label ) : \ 
*(( type * ) pDest ) = \ 
( type ) *pOp1 + ( type ) *pOp2; \ 
break; 


(continued on page 82) 
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(continued from page 81) 


#include <Type.m> 
default: 
break; 
33 


return; 


} 


RAVEKIT 


Listing One 


void Raver: :TimeSlice(long keys) 
{ 
TQAVGouraud vi, v2, v3; 
TQAVTexture ti, t2, t3; 
TQATexture *tex = NULL; 
Tri3D *this_tri = tri_list; 


// The generic Renderer base class handles moving the 3D "world". The 
// vertex objects within the world take care of "projecting" the 

// visible vertices of that world onto a 2D viewport and the Tri3D 

// class contains the Gouraud shading and/or texture info 


// call base class, handle vertex transformations 
// according to input info in keys bitfield 
Renderer: :MoveWorld (keys) ; 


QARenderStart (drawContext, NULL, cache); 
// sadly, no cache cap in default engine 


while (this_tri) { 
// In this example, clipping is only at triangle level. With a bit 
// of edge checking, the gaps could be filled in with a maximum of 
// 2-for-1 triangles (3-for-1 max on corners) 
// uv co-ords also need to be offset 
Vertex3D &v3a = vertex_list[this_tri->vi1] 
Vertex3D &v3b = vertex_list[this_tri->vi2] 
Vertex3D &v3c = vertex_list[this_tri->vi3] ; 
if (this_tri->GetClip(vertex_list)) { 
if (this_tri->texmap > @ && 
this_tri->texmap < num_textures) { 
tex = texTable[this_tri->texmap] .tp; 
if (tex) { 
QASetPtr (drawContext, 
kQATag_Texture, tex); 
= v3a.pix_point.x; 
v3a.pix_point.y; 


. 
’ 
. 
’ 


X= 
oy 
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ti.z = v3a.invZ; 
ti.invW = v3a.invZ;; 


tl.a = 1.08; 
ti.r = 1.0; 
ti.g = 1.0f; 
ti.b = 1.0f; 


ti.uOverW = v3a.u; 
ti.vOverW = v3a.v; 


t2.x = v3b.pix_point.x; 
t2.y = v3b.pix_point.y; 
t2.z = v3b.invZ; 
t2.invW = v3b.invZ; 
t2.a = 1.0f; 

t2.r = 1.0f; 

t2.g = 1.0f; 

t2.b = 1.0f; 


t2.uOverW = v3b.u; 
t2.vOverW = v3b.v; 


t3.x = v3c.pix_point.x; 
t3.y = v3c.pix_point.y; 


t3.z v3c.invZ; 
t3.invW = v3c.invZ; 
t3.a = 1.0; 

t3.r = 1.0f; 

t3.g = 1.0f; 

t3.b = 1.@£; 


t3.u0verW = v3c.u; 
t3.vOverW = v3c.v; 
QADrawTlriTexture(drawContext, &t1l, &t2, 
&t3, kQATriFlags_None) ; 


} 

} 

else { 
vi.x = v3a.pix_point.x; 
vi.y = v3a.pix_point.y; 
vi.z = v3a.invZ; 
vi.invW = 1; 
vi.a = 1.0f; 
v2.x = v3b.pix_point.x; 
v2.y = v3b.pix_point.y; 
v2.z = v3b.invZ; 
v2.invW = 1; 
v2.a = 1.0; 
v3.x = v3c.pix_point.x; 
v3.y = v3c.pix_point.y; 
v3.z = v3c.invZ; 
v3.invW = 1; 
v3.a = 1.0f; 


if (this_tri->type == TRI_MOVEABLE) { 
// calc dynamic lighting here 
// no-op for this demo 


} 

else { 
vi.r = this_tri->rgbi.r; 
vi.g = this_tri->rgbi.g; 
vi.b = this_tri->rgbi.b; 
v2.r = this_tri->rgb2.r; 
v2.g = this_tri->rgb2.g; 
v2.b = this_tri->rgb2.b; 
v3.r = this_tri->rgb3.r; 
v3.g = this_tri->rgb3.g; 
v3.b = this_tri->rgb3.b; 

} 


QADrawTriGouraud (drawContext, &v1,&v2,&v3,kQATriFlags_None) ; 
} 
} 
this_tri = this_tri->next; 
} 
QARenderEnd (drawContext, NULL) ; 


Listing Two 


int Vector3D::Project() 


{ 
if (z <= view_plane) return -1000; 
invZ = 1.@f - view_plane / z; 
scaleZ = scaleZX / z; 
pix_point.x = (int) (raster_centerX + x * scaleZ + 9.5f); 
pix_point.y = (int) (raster_centerY + y * scaleZ + 9.5f); 
return ClipBounds(); 
} 
e e 
Listing Three 


// Renderer: :MoveWorld() - called by derived class. Processes user input and 
// sets up transformation & rotation values which it passes to TransformWorld() 


void Renderer: : TransformWorld( 
float tx, float ty, float tz, 
float rx, float ry, float rz) 


{ 
for (int n = 0; n < num_vertices; ntt) 
vertex_list[n].Transform(tx, ty, tz, 
rx, ry, rz, T_PREROTATION | T_RELATIVE) ; 
} 


(continued on page 84) 
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TITANIUM's multi-model approach 
allows developers to use pure object 
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navigational APIs for elegant code, while 
end-users work with simple relational and 
SQL statements for fast, usable queries. 
A multi-threaded client/server 
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without joins... without 





compromise. i} | | A N | | M management system, 
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For a TITANIUM Technical White Paper, call 800-445-mdbs or 765-463-7200. 
E-Mail: info@mdbs.com WWW: http://www.mdbs.com 


Successful Applications Are Built With TITANIUM. @ mdbs 


Micro Data Base Systems, Inc. 





mdbs and TITANIUM are registered trademarks of Micro Data Base Systems, Inc. ©1997 Micro Data Base Systems, Inc. 
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(continued from page 82) 
Listing Four 
i Snippet from Vector3D: :Transform() 


“else if (t & T-RELATIVE) { 
if (t&T_PREROTATION) { 


x t= tx; 
y t= ty; 
z t= tz; 


Rotate(rx, ry, rz); 
} 
ee ess 
// The rotate component of Transform(). Defined as inline 
void Vector3D::Rotate(float rx, float ry, float rz) 


float sin_a, cos_a, temp; 
if (ry) { 
sin_a = sin(ry); 
cos_a = cos(ry); 
temp = x * cos_a - z * sin_a; 
z= x * sin_a + z * cos_a; 
x = temp; 


} 
af (ex) { 
sin_a = sin(rx); 
cos_a = cos(rx); 
temp = y * cos_a - z * sin_a; 
z= y * sin_a + z * cos_a; 
y = temp; 


} 

if (rz) { 
sin_a = sin(rz); 
cos_a = cos(rz); 


temp = x * cos_a - y * sin_a; 
y = x * sin_a + y * cos_a; 
x = temp; 


Sed 


e e J 
Listing Five 

// Triangles are added to the linked list as indexes into the vertex array. 
// Although RAVE has built-in support for meshs, I've kept it abstracted from 
// the renderer. In Direct3D IM, for example, you can pass your own vertex 

// index list with stride info and so avoid duplication of services 
void Renderer: :AddTri( 

int vil, int vi2, int vi3, // vertex lookup indices 


Uv uvi, Uv uv2, Uv uv3, // texture coords 
Rgb &p_rgb, // the "center" color 
int tmp, int type) // texmap index, type "hint" 
{ 
Tri3D *active_tri, *new_tri; 
active_tri = tri_list; 
while (active_tri) { 
if (active_tri->next) 
active_tri = active_tri->next; 
else 
break; 
} 
new_tri = new Tri3D( 
vil, vi2, vi3, uvi, uv2, uv3, p_rgb, tmp, type, 
lightList, vertex_list) ; 
if (!active_tri) // must be first one 
tri_list = new_tri; 
else 
active_tri->next = new_tri; 
} 


// Vertexes are stored in an array for fast random lookup 
int Renderer: :AddVertex( 

float x, float y, float z, 

float r, float g, float b) 


{ 
if (mum_vertices >= MAX_VERTICES) 
i allocate some more storage here 
return -1; 
Vertex3D &vert = vertex_list [num_verticest+] ; 
vert.Install(x, y, z, r, g, b); 
return num_vertices - 1; 
} 


MOTION BLUR 


Listing One 
#define MAXIMAGES 
int motionBlur(char *firstImagePath, char *outputDir, int 
numFrames, int blurDepth) { 
memImage *images [MAXIMAGES] ; 
char directory [MAXPATH] , fileName [MAXPATH] , prefix [MAXPATH] , 
inSuffix [MAXPATH] ; 
char currentPath [MAXPATH] , inPath[MAXPATH] ; 
int frameNum, i, j, status; 
if(blurDepth > MAXIMAGES) ( 
statusPrint("motionBlur: blurDepth is larger than the limit."); 
return -1; 


// the directory includes the drive letter 
status = getPathPieces(firstImagePath, directory, fileName, prefix, 
&frameNum, inSuffix) ; 
if(status != @){ 
statusPrint("motionBlur: Check the first image pathname") ; 
return -2; 
} 
int imHeight, imWidth, bpp, frameCounter, row, col; 
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status = readBMPHeader(firstImagePath, &imHeight, &imWidth, &bpp); 


if(status != @){ 


sprintf(g_msgText, "motionBlur: Cannot open: %s", firstImagePath) ; 


statusPrint(g_msgText) ; 
return -3; 


} 


for (frameCounter=frameNum; frameCounter<=frameNumtnumF rames ; frameCounter++) { 


// Open and close the appropriate images 
if(frameCounter == frameNum) { 
for(i = @; i < blurDepth; it+){ 
makePath(currentPath, directory, prefix, 
frameCounter + i, inSuffix) ; 
images[i] = 
new memImage(currentPath, 9, @, RANDOM, 
'R', RGBCOLOR) ; 
if (!images [i] ->isValid()) { 
sprintf (g_msgText, 
"motionBlur: unable to open image: %s", 


currentPath) ; 
statusPrint (g_msgText) ; 
return -4; 
} 
} 
} 
else{ 
delete images [9] ; //close oldest image 


for (j = 9; j < numFrames; jt+t) 
images[j] = images[j+1]; 
//open new image 
makePath(currentPath, directory, prefix, 
frameCounter + blurDepth-1, inSuffix) ; 
images [blurDepth-1] = new memImage(currentPath, 9, 
@,RANDOM, 'R', RGBCOLOR) ; 


// blur the images 


char outPath[MAXPATH] , outSuffix [MAXPATH] ; 
memImage *outImage; 
int blur; 
sprintf (outSuffix, "%s\@","b"); 
makePath(outPath, outputDir, prefix, frameCounter, 
outSuffix) ; 
outImage = new memImage(imHeight, imWidth, bpp); 
BYTE red, green, blue; 
for (row = 1; row < imHeight; rowtt) { 
for (col = 1; col < imWidth; col+t){ 
int bucket = @; 
int redBucket = @; 
int greenBucket = @; 
int blueBucket = @; 
for (blur = @; blur < blurDepth; blurt+) { 
switch (bpp) { 
case 8: 
bucket += images[blur]->getMPixel(col, row); 
break; 
case 24: 


images [blur] ->getMPixelRGB(col, row, &red, &green, 


&blue) ; 

redBucket += red; 
greenBucket += green; 
blueBucket += blue; 


break; 
default: 
break; 
} //end switch 
if(bpp == 8){ 


float avgBucket = bucket/blurDepth; 


outImage->setMPixel(col, row, (BYTE) (avgBucket + 


6-5)); 


} 
if(bpp = 24){ 
float avgRedBucket = redBucket/blurDepth; 
float avgGreenBucket = greenBucket/blurDepth; 
float avgBlueBucket = blueBucket/blurDepth; 
outImage->setMPixelRGB(col, row, 
(BYTE) (avgRedBucket + 0.5), 
(BYTE) (avgGreenBucket + 9.5), 
(BYTE) (avgBlueBucket + 9.5)); 
} 
} //end inner loop 
} //end outer loop 
} //end frame loop 


// Save the blurred image 


sprintf(g_msgText,"Saving: %s", outPath) ; 
statusPrint (g_msgText) ; 
outImage->writeBMP (outPath) ; 

delete outImage; 

//end sequence loop; 


} 
// Close the remaining images 
for(i = @; i < blurDepth; i++) 


delete images [i] ; 


return NULL; 


} 


TREAPS 


Listing One 


/ 


* An interface for ordered objects. A class that is to be used 


* as a key in a treap must implement this interface. */ 


public interface Ordered 


{ 


} 


/* Compares two ordered objects. Returns the value @ if this object equals 
* the argument; a value less that @ if this object is less than argument; 
* and a value larger than @ if this object is greater than the argument. */ 


int compareTo(Ordered anotherOrderedObject) ; 


(continued on page 80) 
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(continued from page 8&4) 
Listing Two 


import order.*; 
import java.util.Enumeration; 


class Year implements Ordered 


int year; 
Year(int y) { year = y; } 
public int compareTo(Ordered y) { 
if (year > ((Year) y).year) 
return 1; 
else if (year < ((Year) y).year) 
return -1; 
else 
return 9; 


public String toString() ( 
return Integer.toString (year) ; 


} 


class TreapDemo 


public static void main(String[] args) { 

Treap treap = new Treap(); 

treap.put(new Year(1935), "Elvis Presley") ; 

treap.put(new Year(1926), "Chuck Berry") ; 

treap.put(new Year(1941), "Bob Dylan"); 

treap.put(new Year(1936), "Roy Orbison") ; 

treap.put(new Year(1915), "Muddy Waters") ; 

Enumeration k = treap.keys(); 

Enumeration e = treap.elements(); 

while (k.hasMoreElements()) { 
System.out.print(k.nextElement() + ": "); 
System.out.println(e.nextElement()); 


INTERNET PROGRAMMING 


Listing One 
/* Ping.cpp */ 


#define WIN32_EXTRA_LEAN 
#include <windows.h> 
#include <winsock.h> 


#include <wsipx.h> - 


#include <conio.h> 


ReLEA 
in language technology 


| Stevens, a world renowned programming expert 

and contributing editor for Dr. Dobb’s Journal, 

has created the CD-ROM to answer all your C/C++ 
programming questions — the A/ Stevens Cram Course 
on C/C++. 


This CD-ROM includes the complete text of three books 
written by Al Stevens, an interactive step-by-step tutorial 
with precise explanations, video clips of Al discussing 
important topics, the GNU Compiler Suite directly 
connected to the exercises, lots of usable source code, 
plus a memory feature that bookmarks your place for 
quick returns to prior sessions. 


Use this CD-ROM on your programming projects to answer 
questions, work through actual examples, compile your 
example source code, and make sure it’s correct right 

then and there. 


No matter what your level of programming expertise, the 
Al Stevens Cram Course on C/C++ will help you become a 
more proficient programmer. 


includes these Books by Al Stevens: 
Welcome to Programming; 

Al Stevens Teaches C; 

Teach Yourself ...C++. 


NEW el The Al Stevens Cram Course on C/C++ 


e A collection of 24 exciting developments 





#include "aes.h" 
#define SERVER_SOCKET Ox3200 


SOCKET g_skt; 

BOOL g_serverUp; 

AES *g_aesp; 

AES: :AESHandle g_hEvent; 


void ServerThread(void *) 


if (!g_serverUp) 
return; 
fd_set rdSkts; 
FD_ZERO(&rdSkts) ; 
FD_SET(g_skt, &rdSkts) ; 
struct timeval tv = (5,0); 
int rval = select(@, &rdSkts, @, @, &tv); 


// schedule another pool thread to listen 
g_hEvent = g_aesp->ScheduleEvent(@, ServerThread, 9); 


// use this thread to process client request to completion 
if (rval < @) 
printf("Winsock: select returned %d.\n", WSAGetLastError()) ; 
else if (rval > @) 
{ 


SOCKADDR_IPX addr; 

int recvLen, addrLen = sizeof addr; 

char recvBuf [5]; 

if ((recvLen = recvfrom(g_skt, recvBuf, sizeof recvBuf, @, 
(struct sockaddr *)&addr, &addrLen)) == SOCKET_ERROR) 


printf("Winsock: recvfrom returned %d.\n",WSAGetLastError()); 
return; 


char *resp = strncemp(recvBuf,"Ping",5)?"101 Invalid Request.":"Pong"; 
int respLen = strlen(resp) + 1; 
if (sendto(g_skt, resp, respLen, 0, (struct sockaddr *)é&addr, 
sizeof addr) == SOCKET_ERROR) 
printf("Winsock: sendto returned %d.\n", WSAGetLastError()); 
} 


return; 
} 
BOOL StartServer (WORD wSocket) 
{ 
int err; 
SOCKADDR_IPX addr; 
WSADATA wsaData; 
if (!(g_aesp = new AES)) 
{ 


printf("Unable to create AES object.\n"); 
return FALSE; 


} 
if (err = WSAStartup(MAKEWORD(1,1), &wsaData) ) 


Al Stevens 


This multimedia 
CD-ROM features: 
e Three Complete 
Programming Books 


e Interactive Tutorials 


e Bookmark for 
Quick Returns 


e Video Clips 

e Print and Copy/Paste functions 

e Built in Compiler 
Designed for Win95 and NT (will work on 3.1) 


Price: $69.95 

To Order Call: 

800-992-0549 (U.S. & Canada) 
913-841-1631 (all other countries) 


E-mail: orders@mfi.com 
Fax Orders: 913-841-2624 


Mail Orders: 

Dr. Dobb’s CD-ROM Library 
1601 West 23rd Street, Ste. 200 
Lawrence, KS 66046-2700 USA 





See screen shots and a more detailed explanation on our Website: 


WVAUVAVYAC Lol Maelairaaelcolan 
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af 
{ 


} 
Ge 
{ 


memset (&addr, 9, 
addr.sa_family 
addr.sa_socket 
if (bind(g_skt, 
{ 


printf("WSAStartup returned %d.\n", 
goto erroutl; 


err); 


(LOBYTE(wsaData.wVersion) < 1 || HIBYTE(wsaData.wVersion) < 1) 


printf("Winsock version too low.\n"); 
goto errout2; 


((g_skt = socket (AF_IPX, SOCK_DGRAM, NSPROTO_IPX)) == INVALID_SOCKET) 


printf ("Windsock: 
goto errout2; 


socket returned %d.\n", WSAGetLastError()); 


sizeof (SOCKADDR_IPX)) ; 
AF_IPX; 

htons (wSocket) ; 

(struct sockaddr *) &addr, 


sizeof (SOCKADDR_IPX)) != Q) 


printf("Winsock: bind returned %d.\n", 
goto errout3; 


WSAGetLastError()): 


g_serverUp = TRUE; 
if (!(g_hEvent = g_aesp->ScheduleEvent(®, ServerThread, @))) 


{ 


} 


printf("AES: Unable to schedule event. \n"); 
g_serverUp = FALSE; 
goto errout3; 


return TRUE; 


errout3: 


closesocket (g_skt) ; 


errout2: 


WSACleanup () ; 


erroutl: 


delete g_aesp; 
return FALSE; 


void StopServer (void) 


g_serverUp = FALSE; 
g_aesp->CancelEvent (g_hEvent) ; 
delete g_aesp; 

closesocket (g_skt) ; 
WSACleanup () ; 

return; 


void main(void) 


if ( 
{ 


printf("Server terminated, press any key to exit. 


getc 


StartServer (SERVER_SOCKET) ) 

printf("Server running, press any key to terminate...\n"); 
getch(); 

StopServer(); 


ex Vn") 3 
h(); 


return; 


Listing 
/* AES.c 
#include 
#include 


include 
#include 














unsigned __ 


Pool 
whil 
{ 


} 


retu 


AES: : Poo 


if ( 


retu 

AES: : Poo 
dyin 
ph oan 
{ 


Two 
pp */ 
"AES wh" 
<process.h> 
<limits.h> 
<ertdbg.h> 
stdceall AES::PoolThread::Worker(void *ref) 


Thread& This = *(PoolThread 
e (!This.dying) 


*)ref:; 


Event *event = This.event; 
This.event = Q; 
if (!event) 
WaitForSingleObject(This.sem, INFINITE) ; 
else 
{ 
event->Work(); 
delete event; 


} 
rn @; 


1Thread::PoolThread(int stack /* = @ */ ) : dying(FALSE), 
sem(®), handle(@), event(®), InitState(@) 
!(sem = CreateSemaphore(@, 1, @, @)) 
i; ! (handle = (HANDLE) _beginthreadex(@, 
Worker, @, @, @))) 
InitState = ERR_CANT_CREATE_HANDLE; 
rm; 


stack, 


1Thread: :~PoolThread (void) 


g = TRUE; 
sem) 


if (handle) 
{ 
ReleaseSemaphore(sem, 1, 


0); 
WaitForSingleObject (handle, 
CloseHandle (handle) ; 


INFINITE) ; 


} 
CloseHandle(sem) ; 


retu 


rm; 


(continued on page 88) 
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unsigned __stdeall AES::Monitor(void *ref) 






1 

| 

' { 

' L f AES &This = *(AES*) ref; 

1 e- ots oO — _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_DEBUG) ; 
Z while (!This.dying) 


- New Stuff. : : int eventsWaiting = @; 


ULONG now = ULONG(clock() / CLOCKS_PER_SEC) ; 





inp iegepappintr~*cipigniatrasietr “+=! ULONG nextEventTime = ULONG_MAX, lastComplaintTime = 0: 
From G ree n leaf EnterCriticalSection(&This.critSec) ; 0 
isi for (EventList::iterator eli = This.eventList.begin(); 
Visit us today... eli != This.eventList.end(); /**/ ) 


: { 
http://www.gleat.com/~gleat aia for (int i = @; i < This.size && This.pool[i].Busy(); i++) 
; ii find next available worker 
if (i < This.size && (*eli)->When() <= now) 


1 
: { 


Event *event = *eli; 


' ! 
1 ! 
1 1 1 
' ' e e 
: ’ ee eli = This.eventList.erase(eli); 
: | NEW—ViewComm for Windows eli = This: eventList erase 
' 1 , F } 
1 + Agynch communications debugger & protocol analyzer e. 
1 for Windows 95 and NT. See data and control signals on a ((#e14)->When() <= now) 
1 R&-232 links in real-time or review captured data. Flexible gia a at eevee) 
i] | A . 
' ! trigger system provides start-stop control of display or ae > eee eee 
' capture. Graphical display of modem & control signals. y 
1 1 Data display in hex, octal, decimal, binary. ASCII & EBCDIC LeaveCriticalSection(&This.critSec) ; 
so8 F if (!eventsWaiting) 
1 | data. Character or hex displays. Searches. Many extras. WaitForSingleObject(This.sem, (nextEventTime - now) * 1000); 
tt ; 1 
* * ViewComm/DOS also available. Download TestDrive today: t 
s . . . 4: 
rN http://www.gleaf.com/~gleaf pe eereergeteeeee ees aS 
1 “ _CrtDbgReport(_CRT_WARN, @, 9, @, 
; i "Thread pool overflow. %d events delayed.", eventsWaiting) ; 
1 . lastComplaintTime = now; 
: : } 
' 
1 : : ; Sleep (10@) ; 
i s 
NEW—A\rchiveLib 2.1 
: p ‘ return @; 
; Greenleaf proprietary and PKZIP 2.0x compatible } 
' . F . 1s . ‘ AES: : AESHandle AES: :ScheduleEvent (ULONG ulDelay, 
compression engines. Flexible archiving including void (*pFunc) (void*), void *pData) 
: compatibility with PKZIP. Archive to memory or : Pocnte eevenk 
; 
. H ; ' : _ASSERT (pF ; 
file. PKWARE compatible encryption. Visual Basic, gr gee eT ee ee 
4 Pascal, Delphi, and C/C++ AFls. Supports Windows Weer eee | ecu, 
in 95, NT, Windows 3.1x, OS/2 Warp, and 16- and eventList . push_front (event) ; 
‘ LeaveCriticalSection(&critSec) ; 
‘ 52-bit DOS; ReleaseSemaphore(sem, 1, @); 
a return AESHandle(event) ; 
: ) 
. BOOL AES: :CancelEvent (AESHandle hEvent) 
Oreenleat Comm++ one. Event *event = (Event *)hEvent; 
, : BOOL cancelled = FALSE; 
Async communications the C++ way. Classes for EnterCriticalSection(&critSec) ; 
: ; ‘ ; for (EventList::iterator eli = eventList.begin(); 
file transfer, terminal emulation, screen drivers, elt I= eventiier.end( 2.211%) 
modem and port control, flow control. Supports ee ee 
16550, smart and non-smart multi-port boards. oe 
Supports Windows 95, NT, Windows 3.1x, OS/2 Warp, a fee 
Novell NASI and 32-bit DOS. , 
LeaveCriticalSection(&critSec) ; 
return cancelled; 
) 
AES: :AES(int threads /* = 10 */) : dying(FALSE), sem(@), 
No royalties. Lots of examples. Onscreen handle(@), size(threads), pool(@), InitState(9) 
( 
documentation. Library products come with free // Initialize event list critical section 
source code. 30-day no-questions money-back. Fig) eee eee or ene a aad 


Download free test-drive software. 


if (!(pool = new PoolThread [size] ) ) 
{ 
InitState = ERR_INSUFFICIENT_MEMORY; 


T Call today for complete information, demo, san 
} 
or to order. MasterCard, VISA, AmEx and // Check init state of threads in pool 
: I for (int i= @; i < size; it+) 
Novus; approved PO's if (pool [i] .InitState) 
{ 


InitState = pool[i].InitState; 


4-800-523-9830 eae 


// Create monitor semaphore and thread 
if (!(sem = CreateSemaphore(9, @, 1, )) 
i; ! (handle = (HANDLE) _beginthreadex(@, @, Monitor, this, @, @))) 


Greenleaf Softwa re, Inc. InitState = ERR_CANT_CREATE HANDLE 


16479 Dallas Parkway, Suite 570 — 
Dallas, TX 75246 


} 
AES: : ~AES (void) 
{ 





800.523.9830 972.248.2561 cea 
FAX 972.248.7830 © ae shania 
BBS 972.250.3778 14.4/8/N/1 © iseseeerece, @ 


GREENI.EAF . 
m | WaitForSingleObject (handle, INFINITE) ; 
CloseHandle (handle) ; 


S http://www.gleaf.com/~gleaf ; 
S email info@gleaf.com CloseHandle(sem) ; 
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} 

delete [] pool; 
DeleteCriticalSection(&critSec) ; 
return: 


} 


Listing One 


// Set 
output. 
output 
output. 
output. 
output. 
output. 


up output 
FileName=c: \noises.wav 


. ChannelCount=2 


SamplesPerSec=4410@ 
BitsPerSample=16 
TotalPlayTime=30.@f 
PeripheralType=Headphones 


environment.Reverb(@.0f, TRUE, 1.0f, @.@1f) 


environ 


emitter 
emitter 
emitter 
emitter 


ni.Mode 
n2.Mode 
n3.Mode 
n4.Mode 


ni.Cont 
n2.Cont 
n3.Cont 
n4.Cont 


// Init 
ni.Posi 
n2.Posi 


n4.Posi 
n4.Posi 
n4.Posi 
n4.Posi 
n4.Posi 
n4.Posi 
n4.Posi 
n4.Posi 


ment .SpeedOfSound(@.@f, 525.@f) 


ni=c:\windows\media\Robotz Windows Start.wav 
n2=c: \windows\media\Utopia Recycle.wav 

n3=c:\windows\media\Utopia Windows Start.wav 
n4=c:\windows\media\Utopia Windows Exit.wav 


1( @.0f, 1.0f, 30.0f, 1.0f, 30.0f, 1.@f) 
1( @.Of, 1.0f, 22.0f, 1.0f, 22.0f, 1.0f) 


1(@.0f, 1.0f, 85.0f, 1.0f, 85.0f, 1.0f) 
1(@.0f, 1.0f, 100.0f, 1.0f, 100.0f, 1.0f) 
rolMedia(@.@f, RSX_PLAY, @, @.Of) 
rolMedia(@.@f, RSX_PLAY, @, @.@f) 
rolMedia(@.@f, RSX_PLAY, @, @.@f) 
rolMedia(@.@f, RSX_PLAY, 9, @.@f) 

S81) POST ELONS ese aees ease see aera nese ese seame ae 
tion ( ®.0f, 50.0f, O.0f, O.Of) 

tion ( @.0f, 100.0f, O.0f, 9.Of) 

tion( 0.0f @.0f, 5.0f, 25.0f) 

tion( 3.0f, 150.0f, 5.0f, 25.0f) 

tion( 4.0f, 150.0f, 5.0f, -25.0f) 

tion( 7.0f, @.0f, 5.0f, -25.0f) 

tion( 8.0f, 0.0f, 5.0f, 25.0f) 
tion(11.0f, 150.0f, 5.0f, 25.@f) 
tion(12.0f, 150.0f, 5.0f, -25.0f) 
tion(15.0f, @.0f, 5.0f, -25.0f) 


Aaannndsnnrnrnrnnn 
3 
Fh 
iS) 
nn 


n4.Position(16.0f, @.Of, : Of) 
environment.Reverb(17.@f, TRUE, 1.0f, 0.1f) 
n4.Position(19.@f, 150.@f, Of, 25.@0f) 
n4.Position(20.@f, 150.@f, Of, -25.0f) 
n4.Position(23.@f, 0.G£, Of, -25.0f) 
n4.Position(24.0f, 0.G£f, Of, 25.0f) 
n4.Position(27.@f, 150.@f, Of, 25.0f) 
n4.Position(28.@f, 150.@f, Of, -25.0f) 
n3.Position( @.@f, Q.0f, @.@f, 25.0f) 
n3.Position( 5.@f, 15@.@f, @.@f, 25.@f) 
n3.Position( 6.@f, 15@.0f, @.@f, -25.@f) 
n3.Position(11.@f, O.@£, @.0f, -25.@0f) 
n3.Position(12.@f, @.0f, @.@f, 25.Of) 
n3.Position(17.@f, 150.0f, @.0f, 25.@f) 
n3.Position(18.@f, 150.0f, @.@f, -25.@f) 
n3.Position(23.@f, @.0f, @.@f, -25.@f) 
n3.Position(24.0f, 9@.@f, @.0f, 25.0f) 
n3.Position(29.0@f, 15@.0f, @.@f, 25.@f) 

// Start-em up! ------- n-ne nn nnn nnn nnn nn nnn nnn nnn nana 
listener.Orientation(@.@f, 1.0f, @.0f, O0.0f, 0.0f, 1.@f, @.@f) 
// Move the listener around 
listener.Position(@.@f, 10.0f, 5.@f, 0.@f) 
listener.Position(2.0f, 40.0f, 5.@f, @.@f) 
// Circle once 

listener.Position(4.@f, 50.@f, 5.@f, -10.0f) 


listene 
listene 
listene 


// Cire 
listene 
listene 
listene 
listene 


// Cire 
listene 
listene 
listene 
listene 


listene 
listene 
listene 


( 
r.Position(6.0f, 60.0f, 5.0f, @.@f) 
r.Position(8.@f, 50.@f, 5.0f, 10.@f) 
r.Position(1@.@f, 40.0f, 5.@f, @.@f) 
le twice 
r.Position(12.0f, 50.@f, 5.@f, -10.@f) 
r.Position(14.0f, 60.0f, 5.@f, 0.@£) 
r.Position(16.@f, 50.@f, 5.@f, 10.@f) 
r.Position(18.@f, 40.@f, 5.0f, %.@f) 
le thrice 
r.Position(2@.0f, 50.0f, 5.@f, -10.@f) 
r.Position(22.0f, 60.0f, 5.0f, 0.@f) 
r.Position(24.0f, 50.0f, 5.@f, 10.@f) 
r.Position(26.0f, 40.0f, 5.0f, @.@f) 
r.Position(28.0f, 90.0f, 0.0f, @.@f) 
r.Orientation(27.@f, 1.0f, @.0f, @.0f, @.Of, 1.0f, 0.Of) 
r.Orientation(28.0f, @.0f, @.0f, 1.0f, @.@f, 1.@f, @.@f) 


Listing Two 


MyEmitt 
MyEmitt 


er1.Position(2.0f, 0.0f, 0.0f, @.@f) 
er1.Position(5.0f, 4.0f, 4.0f, 4.@f) 


(continued on page 90) 
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Work there, make waves. 





Imagine helping Fortune 1000 companies push past their own power curves? 
Imagine being turned to for support by the world’s leading software engineers. 
That's life in our Enterprise Customer Unit. Got a passion for perfection? 
Superb decision making capabilities? A desire to show the biggest names in 
business what you’re made of? No one can take you farther than Microsoft. 


Application Development Consultants 

(Openings in Seattle, WA) 

Help with deployments in large corporate accounts where Microsoft technolo- 
gy solutions are used. Conduct application design and code reviews, perfor- 
mance benchmarks, and provide porting/migration assistance, configuration 
management and general development consulting. Developer-level IBM or 
UNIX system background preferred. Strong business background in Fortune 
500 and/or experience with systems technology consulting firm desired. 


Competitive Technical Managers 

(Openings in Seattle, WA) 

Drive the adoption of Microsoft products in enterprise accounts by overcom- 
ing technical objections based on comparison with major competitors. 
Extensive experience in Unix and mainframes, distributed communications 
architecture or Enterprise Consoles required. Seeking candidates with 
advanced degree in CS, or business with 8-10 years technical sales/develop- 
ment, support or consulting with large corporate customers. Extensive 
knowledge of Netscape or Oracle systems and knowledge of Microsoft prod- 
ucts and technologies required. International experience highly desirable. 


Developer Support Engineers 

(Openings in WA and NC) 

Put your coding abilities and critical thinking to the test as you work with 
the latest technologies to provide solutions for other developers’ toughest 


issues. Includes writing sample code, debugging customer code, and analyz- 


ing Microsoft source code. Must have solid coding experience in VB and/or 
C/C++ and the ability to grasp new technology quickly, excellent communi- 
cation skills and a burning desire for customer satisfaction. 


Technical Account Managers-Development 


FOCUS (Openings in WA, TX and NC) 

Assist our Fortune 1000 corporate customers in the use and implementation 
of Microsoft solutions. Must have BS degree and 2+ years corporate MIS 
experience. Experience with networking architecture and added technical 
competence in one of the following areas: programming concepts 


(VB/C/C++); messaging architecture; or database architecture (SQL/Oracle). 


MCSE/MCSD certification desired. 


SQL Course Developer/Trainer (Opening in WA) 
Research, develop and deliver training on cutting edge SQL Server technolo- 
gies. Combine your demonstrated SQL Server experience with solid project 
management, research and communication skills. Technical background 
must include experience with SQL Server, ODBC and transaction processing. 
Must have BS CS/EE and excellent written and verbal communication skills, 
including good presentation and facilitation skills. Must have the desire to 
facilitate technical development of others and be able to organize informa- 
tion for effective teaching. 


OEM PM (openings in WA) 

Manage pre-release development between Original Equipment Manufacturers 
and Microsoft to achieve and implement design wins. Monitor some testing of 
OEM hardware configurations and Microsoft products. Qualifications should 
include a minimum of 2 years experience with computer hardware, desktop 
and corporate systems, development methods, and object management. 


Knowledge of OEM business practices and issues, hardware problems, and res- 


olutions desired. Must be self managed and able to deal with people in time- 
demanding situations. A BA/BS degree in Computer Science or equivalent 
experience preferred. Ability to travel required. 


Microsoft offers a competitive salary, excellent benefits, and substantial 
relocation packages. E-mail your resume in ASCII text format to: 
hireme@microsoft.com (indicate Dept. A28w9-0701 within the text of your 
resume) or fax to: (206) 704-4334 or mail to: Microsoft Corporation, Attn: 
Recruiting A28w9-0701, One Microsoft Way, STE 303, Redmond, WA 
98052-8303. No phone calls please. We are an equal opportunity employer 
and support workforce diversity. 


Microsoft _ 


microsoft.com/ 
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C++/MEC and 
Java Class Libraries 


Stingray offers a complete family of object 
oriented C++/Java class libraries that 
speed your GUI application development! 








Visual C++/MFC Class Libraries 
%* Objective Grid 5.0 


A full featured 100% MFC grid control - supports UNICODE, 
ODBC/DAO/OLE DB, find/replace, sorting, can be bound to any 
data source, and hundreds of other features! 


%* Objective Toolkit 5.0 


A “must have" set of over 60 MFC extensions including docking 
windows, smart edits, tabbed windows, tree, customizable 
toolbar and much more! 


y* Objective Plug-in 1.0 


Internet enable any MFC application by quickly converting it into 
a plug-in. Let our wizard generate a starter application for you - 
works with both IE and Navigator! 


% Objective Chart 1.0 


The first 100% MFC, object-oriented charting/graphing class 
library. Objective Chart can be bound to Objective Grid and also 
supports a variety of dynamic/static 2d/3d graph types! 


% Objective Diagram 1.0 


Add graphical diagram interfaces to your MFC applications 
quickly and easily with Objective Diagram! The Designer 
application helps you design custom graphical tool palettes. 
palettesols. 


Java Class Libraries 
%* Objective Blend 1.1 


An indisposable collection of over 15 AWT extensions that super- 
charge your Java applets. Includes: tree, list, tab control, 
masked edit, smart edits, progress and more! 


% Objective Grid/J 1.1 


A 100% Java version of our popular C++ grid control. We also 
offer a Microsoft AFC compatible version!! 


All products include FULL SOURCE CODE, 30-day money 
back guarantee, 60 days of free technical email support. 


Subscriptions and bundle/site discounts are available! All 
calacl eeree are da dechel sdbleath TODAY! 





See 


; For +r FREE DEMOS Surf to: 





Stingray Software, Inc. 


1-800-924-4223 


Voice: (919) 461-0672 
Fax: (919) 461-9811 
Email: sales@stingsoft.com 





"We add class to MFC/Java!" 
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(continued from page 89) 
Listing Three 


// Output Settings 

output. FileName=c: \mywave.wav 
output. ChannelCount=2 

output .SamplesPerSec=2205@ 
output. BitsPerSample=16 

output. TotalPlayTime=30.0f 
output .PeripheralType=Headphones 


// RSX environment 
environment.Reverb(time, true/false, delay, intensity) 
environment.SpeedOfSound(time, speed) 


// Listener 
listener.Position(time, x, y, z) 
listener.Orientation(time, x, y, z, xUp, yUp, zUp) 


// Emitters 
emitter Emitter@=c:\sounds\bird.wav 


Emitter@.Position(time, x, y, 2) 

Emitter®.Orientation(time, x, y, 2) 

Emitter®.Pitch(time, pitch) 

Emitter®@.Model(time, MaxFront, MinFront, MaxBack, MinBack, Intensity) 
Emitter®@.ControlMedia(time, action, loops, startPos) 
Emitter®.SetMuteState(time, true/false) 
Emitter®.SetMarkPosition(time, startpos, endpos) 


teri: 


Listing One 


clone moo WorldViewer 
add moo { 
behavior { 
bootstrap {remoteHost shape} { 
# Alert a running session on remoteHost that we want to play 


if {SremoteHost != [gethost]} { 
send SremoteHost:[getself] enter “[gethost] {$shape}” 
} else { 


addstate shape Sshape 
} 
} 
enter {host shape} { 
# Register the given host as a player, and let everyone else know 
set hostlist [getstate hosts] 
foreach i Shostlist { 
send [lindex $i @]:[getself] newPlayer “Shost {$shape}” 


send [getsender] startUp “{[lappend hostlist 
“[gethost] {[getstate shape]}”]}” 
send [getself] newPlayer “Shost {Sshape}” 


newPlayer {host shape} { 

# Add the given host as a new player 
set hostlist [getstate hosts] 
addstate hosts [lappend hostlist “$host {$shape}”] 
puts “([gethost]) newPlayer: creating object Shost” 
clone Shost Entity 
add Shost “appearance {$shape}” 


set position [get [getstate camera] state position] 

set orientation [get [getstate camera] state orientation] 

send Shost:[getself] updateState “[gethost] [getstate room] 
{Sposition} {Sorientation}” 


startUp {hosts} { 
# Initialize play 
addstate hosts Shosts 
foreach i Shosts { 
set host [lindex $i @] 
set shape [lindex $i 1] 
puts “([gethost]) startUp: creating object Shost” 
clone Shost Entity 
add Shost “appearance {$shape}” 
} 
send [getself] broadcast {} 


move {} { 

# Move self if flying 
inherited move {} 
send [getself] broadcast {} 


requestUpdates {} { 
# Request an update from every other player 
foreach i [getstate hosts] { 
set host [lindex $i @] 
send Shost:[getself] updateMe 
} 


} 
updateMe {} { 
# Sender wishes to receive update of state 
set position [get [getstate camera] state position] 
set orientation [get [getstate camera] state orientation] 
send [getsender] updateState “[gethost] [getstate room] 
{$position} {S$orientation}” 


} 
broadcast {} { 
# Broadcast current position and orientation to everyone else 
set position [get [getstate camera] state position] 
set orientation [get [getstate camera] state orientation] 
foreach i [getstate hosts] { 
set host [lindex $i @] 
send Shost:[getself] updateState “[gethost] [getstate room] 
{Sposition} {Sorientation}” 
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updateState {host room position orientation} { 
# Update the position and orientation of the player on the given host 
if {$room == [getstate room]} { 
set transform [mconcat [mtranslate $position] “Sorientation”] 
add [getstate scene] “subobject {$host {$transform}}” 
} elseif {[lsearch [inquire [getstate scene] subobject] $host] != -1} { 
remove [getstate scene] “subobject {Shost}” 





} 
} 
} 
} 
e e 
Listing Two 
clone Room Entity 
add Room { 
state { 
scene “” 
window “” 
realized @ 
} 








behavior { 
init {scene window size color} {( 
# Initialize the room 
addstate scene $scene 
addstate window Swindow 
addstate size $size 
add [getself] “appearance { 
shape {box [getstate size]} 
diffusecolor {$color} 
," 
} 
inLimits {x y z} { 
# Check if given point is inside or outside the room 
set width [lindex [getstate size] @] 
set height [lindex [getstate size] 1] 
set depth [lindex [getstate size] 2] 
set min Swidth 
if {Sheight < $min} {set min S$height} 
if {$depth < $min} {set min $depth} 
set pad [expr 0.05*Smin] 
if {Spad < $x && $x < [expr Swidth - Spad]} { 
if {$pad < Sy && Sy < [expr Sheight - $pad]} { 
if {Spad < $z && $z < [expr Sdepth - Spad]} { 


} Introductionto Java Programming & Core Hands On Java 
Programming Java Applets| === Class Libraries Programming, Using 
ae ) _ Microsoft Ja: 


} 
realize {target position up} { 
# Display the room and its contents 
addstate realized 1 
add [getstate scene] “subobject {[getself] {[midentity]}}” 
set x [expr @.5*[lindex [getstate size] @]] 
set y [lindex [getstate size] 1] 
set z [expr @.5*[lindex [getstate size] 2]] 
send [getstate window]-light(2) setView “{$x [expr 0.5¥*$y] 0.0} 
{Sx Sy $z} {@ 1 0}” 
send [getstate window]-light(3) setView “{$x [expr 9.5*$y] 
[expr $zt+$z]} ($x 0.0 $z} {® 1 0)” 
set camera [get [getstate window] state camera] 


send Scamera setView “{Starget} {Sposition} {$up}” «tN pro. Mai aging the Risks 
add [getstate window] “state {defaultPos {$position} : 
defaultTar {S$target}}” 


send [getstate window] setRoom “[getself]” 
send [getself] callback realize 
} 
unrealize {} { 
# Disable the room’s display 
addstate realized @ 
remove [getstate scene] “subobject {[getself]}” 
send [getself] callback unrealize 


Listing Three 


clone Bridge Entity 
add Bridge { 
state { 
portals {} 
} 


behavior { 

init {color room@ target® position® up® rooml target1 position1 up1} { 

clone [getself]-@ Portal 

send [getself]-@ init “[getself] Sroom@ {$target} {Spositiond} 

{Supd} {Scolor}” 
clone [getself]-1 Portal 
send [getself]-1 init “[getself] Sroom1 {$target1} {$position1} 
{Sup1} {S$color}” 

addstate portals “[getself]-® [getself]-1” 

add [getself] “subobject ({[getself]-@ [getself]-1}” 
} 
crossBridge {portal} { 

set i [lsearch [getstate portals] $portal] 

if ($i == -1} { 

puts “([getself]:oppositePortal) Unrecognized portal ‘S$portal’” 
} else { 

set i [expr 1 - $i] 

set portal [lindex [getstate portals] $i] 

set position [get Sportal state position] 

set target [get Sportal state normal] 

set position [vadd Sposition [vscale 1.1 $target] ] 

set target [vadd Sposition $target] 

send [get Sportal state room] realize”{$target}{Sposition} {@ 1 0}” 

} 
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Dr. Dobb's 
Distributed Objects Development CD-ROM 


The latest in distributed 
object technology, including languages, 
libraries, and environments 


Programming distributed systems using traditional tools is both comple po ee > 
and error prone. That's why the editors of Dr. Dobb's assembled this es o 
collection. Using this CD-ROM will enable you to build reliable 
distributed, object-oriented applications. And since the Internet 
and World Wide Web are rapidly increasing the demand for 
distributed applications, these tools and utilities are at the very 
heart of this technology. 


This CD-ROM contains over 100 megabytes, featuring: 

e Arjuna 3.3.2—A robust O-O tool for building fault-tolerant 
distributed applications out of C++ programs 

e Shadows —Creates World Wide Web Arjuna applications 

e Interlanguage Unification System (ILU)—A powerful programming 
model for distributing applications via an Interface Description 


¢ Obliq—An O-O scripting language supporting distributed computation For a detailed 
¢ Visual Obliq—The World Wide Web version of Oblia description, please 
¢ Phantom —A stand-alone, interoreted language for developing large- visit Our web site: 
scale, interactive, distributed applications www.ddj.com/cdrom/ 
¢ Distributed Python—A portable, interoreted, O-O language which is 
extendable Order your 
Se copy today! 
me the Dr. Dobb's Distributed Objects CD-ROM immediately. | will also receive the 
Dr. Dobb's Sourcebook, Distributed Objects as a bonus. | understand that | have a full money-back guarantee. | F fe F - Te N U S! 
Distributed Objects Development CD-ROM..........cccccsssecseseeeceseeececeesececeuceeeeeneeeesaceesesteeeenseeeeennees $39.95 | Get a FREE Dr D nishy's 
Please add sales tax in the following states: CA (8.5%), GA (6%), IL (6.25%), KS (6.9%), NY (8.25%), Sourceboo kon 
TX (8.25%), Canada (7% GST). s___ | [Bi pyemediicteRelel cre caras 
Shipping ($2.00 for each CD-ROM shipped in USA/Canada, $10.00 for Airmail to all other countries.) S Wo] 6) a: @3 BES 1@) \¥/ | ol0|oialeny-s 
TOTAL NOUN cco secre ers cerwagst cence secs rene sect caan tb obd rina tvaneses hice sets ceansapiataesseieod S | 
Name | 
Address , 
| 
City/State/Zip 





| INT'L Orders: 


Use mail, fax, e-mail, or call 
Phone E-mail | 913-841-1631 


Here’s how I'm paying (circle one): VISA - MC - AMEX - Check enclosed 
| FAX: 913-841-2624 


Credit card number (include all digits) Expiration Date | E-Mail Orders: 
orders@mfi.com 


Mail Orders: 


Please allow 2 weeks for delivery in the U.S./Canada; 4 weeks for all other countries, Checks/money orders must | Dr. Dobb's CD-ROM Library 


be drawn on a U.S. bank in U.S. funds only. DJ 97 ; 1601 es Pe ct ac 
awrence, 


Signature required | 


PROGRAMMING PARADIGMS 


Java Bashing, Books, 


and Beans 


Michael Swaine 


t is an unquestioned article of computer 

faith that James Gosling originally 

named the Java language “Oak” in hon- 

or of a tree outside his office window. 
According to this official Sun story, the 
name Java only emerged after a long trade- 
mark search. 

I wonder. 

I mean, think about it: We’re talking 
about James Gosling, one of the most caf- 
feinated programmers on the planet. Let 
me quote from the definition of “tense” in 
The Hacker's Dictionary (Guy L. Steele et 
al., Harper & Row, 1983): 


This routine is so tense it will bring tears 
to your eyes. Much thanks to Craig Ever- 
hart and James Gosling for inspiring this 
hack attack. 


And from the definition of “hack attack,” 
so there can be no doubt about the state 
of wiredness being induced here: 


I’ve been up for thirty hours; I had a hack 
attack and finished off that new feature I 
thought would take two weeks to program. 


You get the picture, right? Since his MIT 
days, Gosling has been staying up late, 
staring bleary-eyed at a computer moni- 
tor, writing tense code that inspires hack 
attacks. And we all know what that means. 
Coffee. Possibly cappuccino. 

Second point: Consider the picture we 
now have of Gosling, the bleary-eyed, 
caffeine-wired hacker, cranking out code 
so tense it brings tears to your eyes. I ask 
you, is this a person who stares out his 
office window? Is this a person who 
knows that he has an office window? Or 
is this a guy who invents a language and 
names it after his favorite drug? I think all 
this Oak business is just an urban legend. 


Let It Be C 

My recent rehashing of Ward Mullins’ ten 
criticisms of Java inspired some reader 
mail. 


Michael, DDJ’s editor-at-large, can be con- 
tacted at mswaine@cruzio.com. 
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Bill Marsh thinks that only numbers one 
through four of Mullins’ list of criticisms 
are valid complaints about the language, 
the other six being complaints about the 
atmosphere surrounding it. “I was sur- 
prised,” Bill says, “that there was no men- 
tion of the ease of network programming 
with Java. This makes the language worth- 
while by itself.” 

Indeed. Java benefits from having come 
into existence after the importance of be- 
ing totally wired (Netsavvy, that is) had 
been made manifest. It was defined from 
the start (or from 1.0 anyway) to provide 
a lot of Net capabilities, with classes for 
creating and manipulating data packets, 
sockets, and URLs. Although Sun’s claims 
about Java being easy to program in are 
exaggerated, it really is surprisingly easy 
to put together Internet applications and 
applets with Java. Right on, Bill. 

Edward Diener thinks that all this fuss- 
ing over Java’s faults and virtues sounds 
a lot like certain articles that used to run 
in Computer Language magazine. Ed was 
apparently not a fan of CZ. “Each issue 
seemed to feature some ludicrous debate 
about the best computer language in 
which to write a program. After a few is- 
sues of this, I ended my subscription. I 
have also done my best to avoid all de- 
bates about which language is better than 
which language. After all, could you imag- 
ine arguing with an Italian that Russian is 
better than his language? Or vice versa? 
Absurd!” 

Actually, I can easily imagine an Ital- 
ian and a Russian arguing over the rela- 
tive virtues of their languages, although 
not as easily as I can imagine a French- 
man and a German doing so. Linguistic 
ethnocentrism is, if anything, more viru- 
lent for natural than for artificial languages. 
There’s an interesting online publication 
out of Munich (http://www.heise.de/tp/ 
tpfhome.htm) where you can read an ar- 
ticle about how English is doomed to ex- 
tinction because of the Web. The article, 
I need hardly mention, is written in En- 
glish. But I digress. 





Say on, Ed Diener, say on. 

“My biggest gripe regarding Java,” Ed 
continues, “is that every mention of it 
comes with a corresponding putdown of 
C++. Why? Unless I am missing some- 
thing deep, Java is about 85% C++ give 
or take 10%. If you like Java, enjoy your- 
self. I like C++. Maybe Ill learn Italian 
some day. Maybe you'll learn Russian. 
Who knows?” 

Good call, that, about everybody gra- 
tuitously bashing C++ as they rush to de- 
ify Java. I may not be the best person to 
respond, since I never became a C++ fan, 
no doubt because I never got very good 
at programming in it. And Java is certain- 
ly highly similar to C++ in syntax, mak- 
ing my enthusiastic embracing of Java look 
a little silly. But I think the point Ed is 
missing is that the Java hoopla is not about 
Java the language, but about Java the phe- 
nomenon. 

Java the phenomenon encompasses 
JavaOS the operating system, JavaBeans 
the software component architecture, 
Java microprocessors, and a plethora of 
APIs, as well as Java the language. Java 
the phenomenon is spreading like mold 
on the surface of a misplaced cup of cof- 
fee. Books on Java are popping up as 
fast as web books last year or Internet 
books the year before. Companies do- 
ing embedded applications, smartcards, 
and thin clients are committing their for- 
tunes to Java-based technologies that are 
today more promise than delivery. Ap- 
ple has latched onto Java as though it 
will be the salvation of the company. It’s 
hard to understand why, because there’s 
not much here that we haven't seen be- 
fore. “Write once, run everywhere” 
sounds great, but it rests on an object 
model derived from C++ and a bytecode 
approach last seen in the UCSD p-system 
back in the ’80s. 

Sun is pushing Java as the answer to 
security on the Net, and there are sever- 
al security measures built into Java and 
the applet model, but nothing that couldn't 
be implemented without Java. 


a 








JavaBeans provides an interesting mod- 
el for creating component software, an 
exciting possibility, but so, in different 
ways, do ActiveX and OpenDoc. 

The explanation for Java the phe- 
nomenon seems to have something to do 
with the right pieces being put together in 
the right way at the right time and pro- 
moted in the right way. “Write once, run 
anywhere” not only sounds good, it sounds 
like an answer to the Wintel monopoly. 
And Sun is brilliantly managing to associ- 
ate the words “Java” and “security” in the 
minds of people who don’t know what 
Java is or what the real Internet-security 
issues are. 

Those people matter, the people who 
know frighteningly little about comput- 
ers but control departmental budgets. 
They tend to latch onto a magic phrase 
that they think will keep them out of 
trouble. In the 1980s, they asked “Is it 
IBM compatible?” In the 1990s, they 
asked, “Does it run Windows?” And I can 
almost hear them starting to ask, with- 
out having a clue what it means, “Was it 
written in Java?” 

I suspect that Ed will learn Java, but who 
knows? I know this: There is zero proba- 
bility that ’'m going to learn Russian. 

William Beebe connects my Java jabs 
with the musical parodies I quoted from 


Don Slepian and comes up with a little 
ditty of his own: 


When my project’s hit a brick wall 
K&R, they come to me 
Speaking words of wisdom 
Code in C 


Code in C, Code in C 
Code in C, yeah, Code in C 
Java’s not the answer 
Code in C 


“Since programming and music are sup- 
posedly intertwined within the psyche of 
the programmer,” William says, attempt- 
ing to palm off one of the ripest chest- 
nuts of computer lore, “maybe you should 
have a musical language parody contest.” 

Not a bad idea, William. See the last 
page of this issue. 


Bashing Books 
In trying to stay on top of the Java phe- 
nomenon, I read mailing lists, online 
pubs, magazines, and books, as well as 
my e-mail. The books almost invariably 
disappoint. The current crop, in fact every 
wave of them so far, seem more than usu- 
ally rushed. Some semirandom examples: 
Laura Lemay has become a technical- 
book publishing empire unto herself. Her 
name may not be as big a draw as the 


ubiquitous Dummy, but it’s creeping up 
there. One such entry is Lemay’s Teach 
Yourself Java for Macintosh in 21 Days 
(Laura Lemay and Charles L. Perkins, with 
Timothy Webster, Hayden Books, 1996). 
Like all her books, it is thoughtfully or- 
ganized and well written (although, in this 
case, not written entirely or even mainly 
by Lemay), but it is poorly edited. 

There are syntactic errors in the code, 
errors in tables, and errors in the text, in- 
cluding mistakes that seriously affect the 
usefulness of the book. And there’s no ex- 
cuse for publishing code with syntactic er- 
rors. Zero syntax errors is easily achiev- 
able, so anything less is unacceptable. 

The Lemay book is not alone. In fact, 
despite its errors, I think it’s one of the 
best Java books out there. 

Freddy Hill writes, “An acquaintance 
of mine, Lewis, had purchased Norton’s 
book on Java, and the book was filled 
with typographical errors in the code. 
Since Lewis was a novice, he could not 
find the errors; thus, he halted his at- 
tempts to learn Java.” 

I haven’t read the Norton book, but 
Freddy’s tale of woe doesn’t surprise me. 
Core Java, Second Edition, by Gary Cor- 
nell and Cay S. Horstmann, SunSoft 
Press/Prentice Hall, 1997) is another high- 
ly regarded Java book, and deservedly so. 


PCYACC’ Version 7.0 


PROFESSIONAL LANGUAGE DEVELOPMENT TOOLKIT 


Includes “Drop In” Language Engines for SQL, dBASE, POSTSCRIPT, 
HYPERTALK, SMALLTALK-80, C++, C, PASCAL, PROLOG, FORTRAN, 
COBOL, BASIC, SGML, ASN, RPG, REXX, PL1, SNA, RTF, VISUAL BASIC, 
SQL2, DB2, VHDL, HTML, VMRL, JAVA, ODMG-ODL/OQL, SQL3, MODULA-3, 
DELPHI, VBS, and ADA. 


PCYACC Version 7.0 is a complete Language Development Environment that gen- 


erates C, C++, Java, Delphi, and VBS source code from input Language Description 

Grammars for building Assemblers, Compilers, Interpreters, Browsers, Page Descrip- 

tion Languages, Language Translators, Syntax Directed Editors, Language Validators, 

Natural Language Processors, Expert System Shells, and Query languages. 

= Portable Object Oriented Classes for C++ and JAVA - Error, Symbol 
Table, Syntax Tree, Yacc, and Lex. 


= Debugging tools include runtime Visual Parser Debugging, Abstract 
Syntax Tree generation, and Cross Referencing. 


CodeCheck’” Version 7.0 


SOURCE CODE ANALYST 


Includes “Drop-In” Rules for Compliance analysis, Adherence to specifica- 

tions, Measures of complexity, Silent error detection, Code maintainability, 

and Portability. 

CodeCheck Version 7.0 is a programmable tool for managing all C and C++ source 

code on a file or project basis. CodeCheck is input compatible with all variants of 

K&R, ANSI C and C++ (Microsoft, Metaware, Borland, Intel, Vax/Vms, HP/Apollo, 

Microtec, Watcom, Symantec, MPW, CodeWarrior, AT&T, and GNU). CodeCheck 

is designed to solve all of your Portability, Maintainability, Complexity, Reusability, 

Quality Assurance, Style Analysis, Library/Class Management, Code Review, 

Software Metric, Standards Adherence, and Corporate Compliance Problems. 

# Portability - CodeCheck identifies code that will not port between MSDOS, 
OS/2, Unix, VMS, WIN-95/NT, Macintosh and porting to 64 bit machines. 

= Compliance —- CodeCheck allows your corporate coding and project specifi- 
cation standards to be completely automated for compliance validation. 
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The authors know their stuff and share a 
lot of practical advice that could only come 
from being down in the trenches. They 
also speak honestly and thoughtfully about 
what they like and don’t like about Java. 

But the book is, again, not well edited. 
A good editor could have helped these 
guys with the organization of their mate- 
rial, and alerted them when they were re- 
peating themselves unnecessarily. 

A minor gripe: Core Java should really 
be called Core Java for Windows 95 Pro- 
grammers. The examples, tips, and in- 
sights are nearly all Win95 specific. There 
are some allusions to Solaris and a fleet- 
ing acknowledgment that the authors have 
heard of something called a Macintosh. 
But this is really a Win95 book, a limita- 
tion nowhere indicated on the cover. 
There is nothing unusual in this, unfortu- 
nately. Computer-book publishers are get- 
ting more casual than ever about ac- 
knowledging such limitations. But in the 
platform-transcending atmosphere of the 
late 1990s, maybe we shouldn’t let them 
get away with it. 


Bean Book 

Book authors and publishers have an in- 
surmountable problem in a fast-moving 
area like Java programming. There’s real- 
ly no way they can keep up, and even the 
standard references go quickly obsolete. 
Version 1.1 changes so many things that 
those just getting started with Java now 
are perhaps lucky that they can just jump 
in at the 1.1 level. A warning: It’s really 
important to publishers to have the latest 
version number on the cover, even if the 
author has only briefly seen a beta. Com- 
pare the copyright date with the release 
date of the new version before you ac- 
cept the claims on the cover. 

One Java book in which I haven't yet 
found any typos is Michael Morrison’s Pre- 
senting JavaBeans (sams.net Publishing, 
1997). This may just be because I’ve been 
reading so many books lately that I’m get- 
ting bleary-eyed (but not in the tense 
Gosling way; this is more of a loose goose 
blear). 

JavaBeans is, of course, Sun’s API for 
developing component software. It in- 
cludes the needed interfaces and classes 
for creating beans, as these software com- 
ponents are called. Presenting JavaBeans 
does a good job of presenting JavaBeans, 
and includes four sample beans on the 
accompanying CD-ROM, including beans 
for an LED display and a simple audio 
player. 

I like Morrison’s organization. He starts 
off with 40 pages of introduction, in which 
he lays out the basic concepts of compo- 
nent software and the various facilities 
provided by the JavaBeans API, explain- 
ing what they're for and why you might 
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want to use them. Then he jumps right 
into the API, detailing its features so that 
you know what you've got to work with, 
and then, around page 125, he gets to 
some examples of bean construction. 
Mac developers should note that the 
BDK, or Bean Developer’s Kit, is not avail- 
able for the Mac at the time I am writing. 
Versions for Windows 95 and NT and So- 
laris are included on Presenting JavaBeans 
accompanying CD, but you'll have to 


JavaBeans 
provides an 
interesting model 
for creating 
component software 


download the Mac version when it’s avail- 
able from Sun’s site; it’s free, though. And 
sams.net does acknowledge this on the 
cover of the book. 

Seems like everybody is developing 
beans now, but that’s probably an illusion 
of the SunSoft reality repurposing machine. 
Still you wonder when a company you 
thought was dead resurfaces as a bean 


~ factory (http://www.taligent.com/). 


Morrison calls JavaBeans “possibly the 
most exciting and promising software 
component technology available.” I had 
to check the publication date on this book 
myself; the “available” qualifier sounded 
just too appropriate. But no, Morrison de- 
livered his manuscript before Apple an- 
nounced that it was pulling out of Open- 
Doc development. Just prescient, I guess. 

Because a reasonable argument can be 
given that OpenDoc was a particularly ex- 
citing and promising software component 
technology, albeit a component technol- 
ogy of a different sort. 

The OpenDoc idea is, or was, to give 
components to mere users and let them 
configure their own integrated software. 
Sort of like UNIX pipes, only not really. 
More like audio components. I speak as 
though that option is now closed, but in 
fact OpenDoc is not dead. It’s just been 
pulled off life support. 

Apple’s position, stated at one of this 
year’s cutbacks, is that it’s moving its com- 





ponent technology resources from Open- 
Doc to Java, whatever that means, and 
that the releases of OpenDoc and Cyber- 
Dog that ship with Mac OS 8 (formerly 
known as 7.something) will be the last 
major update to Mac OpenDoc. There 
will be no OpenStep API for OpenDoc. 
CI Labs has been disbanded and its as- 
sets returned to its sponsor companies, 
principally Apple and IBM. IBM may still 
be planning to support the Windows ver- 
sion of OpenDoc. 


Black on Black 

One phrase I like to keep in mind when 
thinking about component software is 
“how to hook a customer directly to a 
product.” It’s not terribly catchy or origi- 
nal or surprising, but it reminds me that 
there is a constant battle to eliminate the 
middleman, and that it can always be done. 

The phrase is from Roger Black’s Web 
Sites that Work (Roger Black and Sean EI- 
der, Adobe Press, 1997). Black is a famous 
designer, mostly of magazines. I’d say 
more, but Black says it far better in the 
book.than I can here. There are those who 
think that Black is just a bit, shall we say, 
full of himself. In this book, he graceful- 
ly acknowledges his coauthors and re- 
moves himself from the book in the in- 
troduction by the technique of banning 
the first person from the book. Or that’s 
the theory, anyway. The third-personing 
of the author actually has a very different 
effect. Roger Black is one of the themes 
of the book. There’s a chapter of Black’s 
from-the-hip prognostications about the 
Web, a chapter of images from his past 
work, quotes about Black from the edi- 
tors of Wired, and so on. 

Nevertheless, the book is a real boon 
to anyone trying to make sense of web- 
page design. It’s full of firm dos and 
don'ts, like “Don’t repurpose,” “Make 
everything as big as possible,” “Put con- 
tent on every page,” and “The first color 
is white; the second color is black; the 
third color is red.” 

When you're dealing with design issues 
but aren’t a professionally trained design- 
er, what you want most is strong clear as- 
sertions that cover all the decisions facing 
you and eliminate the ambiguities and 
grey areas. And you don’t care whether 
the assertions are the best possible views 
on the issues; you just want them to be 
not wrong. 

That’s Black. 

By the way, regarding that urban leg- 
end of Java’s naming, I have heard an- 
other theory of how the language got its 
moniker. This one says that Java is an 
acronym for “Just Another Virtual Archi- 
tecture.” That can’t be true, can it? 
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C for C++ 
Programmers 


Al Stevens 


fter reading this column, you might 

be tempted to accuse me of exer- 

cising the Pournellian imperative by 

using my column to promote my 
own books. Yes, I am going to discuss 
some books that I wrote. No, the typical 
reader of this column, who already knows 
C and C++, does not need to buy or read 
any of these books. Therefore, these 
plugs— er, discussions—won’t serve to 
increase my royalties by any significant 
amount. They do, however, lead to some 
discoveries about C and C++ that I will 
share with you. 

It started early this spring when I be- 
gan work on a fifth edition of an intro- 
ductory C++ book called Teach Yourself 
C++. I’ve never liked that title, which the 
publisher chose for the first edition in 
1990. after | rejected C++ for C Pro- 
grammers, Which Ira Pohl had already 
used. I always considered the title “Teach 
Yourself” to be only a notch higher on 
the schlock scale than something like 
Quantum Electrodynamics for Dummies. 
Someone must have liked it, however, 
because at least two other publishers 
have published books with the same 
dumb title. Tithe notwithstanding, the 
work has been professionally and fi- 
nancially rewarding, and I am proud of 
the content, particularly as it has changed 
and grown since the first edition. The 
fifth edition is, I think, the best. 


If (Editions == 5) Why? 

There are several reasons to upgrade a 
book that addresses technology— the 
technology changes, the author’s knowl- 


Al is a DDJ contributing editor. He can be 
contacted at astevens@ddj.com. 


Dr. Dobb’s Journal, July 1997 


edge changes, the potential readership 
changes, or some combination thereof. All 
these reasons apply to this new edition of 
TYC++, and I'll discuss them and address 
some things about C++ that I discovered 
as I modified major parts of the book. 
Writing a new edition of a program- 
ming language book means starting with 
the previous edition, going through it 
chapter by chapter, exercise by exercise, 
and reviewing what has changed in the 
language. There’s probably no reason to 
revise a language book if the language 
hasn’t changed, other than the usual pub- 
lisher avarice and rapacity. (Don’t wor- 
ry. I’m not in any trouble. Publishers tend 
not to know words like that, and editors 
don’t bother telling them.) The C++ draft 
standard has undergone only minor 
changes since the publication of the 
fourth edition of TYC++, but the C++ 
language being used has seen dramatic 
differences, primarily because more and 
more compilers now implement recent 
language inventions (also called inno- 
vations) of the ANSI committee. From 
my perspective, the so-called standard 
language is, at any given time, what is 
available and acceptable to programmers, 
rather than what is under deliberation. 
The final (we hope) draft standard doc- 
ument is still being considered, and no 
compiler has yet implemented the com- 
plete standard language as currently de- 
fined. Consequently, even though the 
fifth edition of TYC++ is still in the works, 
I have already agreed to write a sixth. 
Watch for it around Christmas of 1999, 
irrespective of the committee’s status and 
the compilers’ compliance. Whatever else 
happens, the C++ of late 1999 shall be 
the C++ of record as far as this author is 





concerned. At least that’s what I’m say- 
ing now. 

Changes in my understanding of the 
language and how it ought to be used 
influenced the fifth edition, too. Over the 
years, the book’s content and my knowl- 
edge of C++ have been affected by the 
comments of readers and C++ experts. 
Greg Comeau of Comeau Computing, 
who knows a lot more about C++ than 
most of us, generously spent some time 
and marked up a copy of an early edi- 
tion to correct some errors. John Dlugosz 
offered suggestions in areas where my 
code worked with contemporary com- 
pilers but did not conform to acknowl- 
edged C++ conventions or proposed 
standards. Those are only two of the 
many programmers who helped me. 
Since 1990, I have read many books on 
C++ and learned from most of them. My 
own programming experience on sever- 
al different platforms— DOS, Windows 
95, Windows NT, OS/2, UNIX— has, 
over the years, changed my views of 
how C++ code ought to be written. All 
these things and all these people change 
what I understand and, consequently, 
what I write. 

Finally, changes in the kinds of pro- 
grammers who need a book like this — 
its targeted audience — affect its content. 
All the previous editions, like most intro- 
ductory books on C++, assume that the 
reader is a C programmer. I wrote a com- 
panion book, called Al Stevens Teaches C 
(another publisher-suggested title that I 
came to hate), for programmers who do 
not yet know C. 

Since then, I have discovered two 
things. First, the C component of C++ has 
significant differences from ANSI C. (Not 


a2 


necessarily news when regarded in frag- 
ments, but substantial when viewed as a 
whole.) Some of these differences are 
found in the language itself, others are re- 
flected in how C++ programmers use the 
language. Second, most C programmers 
have already made the move to C++. 
There is not nearly as much need for a 
C++ book that assumes a C programmer 
as there used to be. Potential readers of 
an introductory C++ book today are pro- 
grammers who know neither language. 
Consequently, I decided to adapt some 
of the C book’s contents into the first 
several chapters of the C++ book, turn- 
ing 7YC++ into a book that covers the 
subject wall to wall. And that’s where I 
made some interesting discoveries about 
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C from a C++ perspective. I think that 
most programmers who ascended from 
C into C++ know and understand these 
things, but viewing them as a group pro- 
vides a dramatic insight into how C++ 
has influenced its C component. And 
viewing them from the surrogate per- 
spective of someone who knows neither 
language and is learning C++, which the 
author of such a tutorial must do, is a 
revealing exercise. I offer these obser- 
vations, conclusions, and opinions here 
for anyone who sets out to teach C++ 
with or without my book. 


C++(Cj==--C 
First off, ee is a lot about C that you 
might not need to teach. For starters, the 
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whole stdio family of functions, although 
included in C++, has become unneces- 
sary, having been replaced by the C++ 
stream classes. What's the point of teach- 
ing two ways to do something when the 
contemporary way is clearly superior? Re- 
member, you are teaching C++— not C— 
to a programmer. It’s sufficient to refer 
those who are interested in ANSI C to an 
ANSI C textbook. Why dwell on malloc, 
calloc, and free when the C++ new and 
delete operators do a better job? You can 
bypass teaching setjmp and longjmp, too, 
because C++ exception handling does the 
same thing only better. You don’t have to 
mention NULL because C++ programmers 
tend not to use it. Certainly, you can leave 
out the old-style C function parameter 
declarators. C++ compilers don’t support 
them. You don’t have to explain the 
need for void in a prototype’s empty pa- 
rameter list, because C++, although it 
permits a void parameter list, does not 
need the void keyword to distinguish a 
prototype from an old-style C function 
declaration; C++ does not support the 
classic K&R C function declaration. C 
typecasts are old hat now that we have 
C++ new-style casting. The string.h func- 
tions are candidates for the junk pile, 
being replaced by the more intuitive C++ 
string class. 

After much thought, I decided to teach 
some of the obsolete (from a C++ pro- 
grammer’s perspective) C idioms and 
briefly touch on the Standard C library’s 
string, memory allocation, and setjmp 
functions if only because a C++ pro- 
grammer is likely to run into them. 
Sometimes the C string functions (strcpy, 
strcmp, and the like) are more efficient 
than the C++ string class, which can 
make a difference in a time-critical ap- 
plication. I found setjmp and longjmp 
particularly useful as a precursor to C++ 
exception handling because they do ex- 
plicitly what the C++ try, catch, and 
throw operators do under the surface. 
So, this particular obsolete C behavior 
turns out to have a lingering use after 
all. I also decided to address C casts dur- 
ing an exercise early in the book. The 
exercise needed a cast and the book was 
nowhere near an advanced-enough stage 
to teach the appropriate new-style cast. 
Finally, if you are going to teach a pro- 
grammer to overload global new and 
delete, it’s easier if you start by teaching 
malloc and free. 
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CPP = Forever 

You cannot, however, ignore the prepro- 
cessor, even though many C++ luminaries 
would like to see the preprocessor quiet- 
ly become extinct. Inline functions are an 
improved way to write macros with pa- 
rameters, and const variables replace 
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#defined global symbols, but these im- 
provements do not totally replace macros, 
particularly when certain macro constructs 
provide mnemonic expressions that ex- 
pand into complex initialized data struc- 
tures. Prominent examples are the macros 
that GUI application-framework class li- 
braries use to manage things such as mes- 
sage maps. And consider the trace macro 


#define trace(p) cerr << #p"="<< p << endl 


that I use to avoid launching the cantan- 
kerous gdb debugger. You can’t do that 
with inline functions. You must teach the 
preprocessor because, sooner or later, 
most C++ programmers need it. 


If (C++ > C)... 

Most introductory C++ books include 
chapters somewhere near the beginning 
that discuss the differences between C 
and C++ with respect to notational im- 
provements that C++ makes. Examples 
of these are the scope resolution opera- 
tor, default function arguments, unnamed 
function parameters, the fact that func- 
tion prototypes are required, variable dec- 
laration placement, inline functions, 
anonymous unions, variable declaration 
inside of for-loop and if-condition ex- 
pressions, double-slash (//) comments, 
const instead of #define, structs as types, 
references, function overloading, and the 
signed type specifier. 

An introductory C++ course that does 
not assume a student’s knowledge of C 
presents a quandary. These subjects are 
best addressed in the C++ context in 
which they occur rather than as C im- 
provements. The explanations of, for ex- 
ample, unnamed function parameters and 
default function arguments should ac- 
company the discussions on function pa- 
rameters and arguments — as an integral 
part of the C++ language rather than as 
an extension to C. So what’s the 
quandary? Just this. The student who, co- 
incidentally, happens to already know C, 
may be tempted to sleep through— or, 
in the case of a book, skip over— the 
function parameter/argument discussion 


void foo(struct Date yesterday) 
{ 


flow. 
goto bypass; 
{ 


struct Date today = yesterday; 
//] 


bypass: 
flows, 


} 
j 


Example 1: Valid C, invalid C++, 
goto usage. 
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and, by doing so, misses learning about 
the improvements. What to do? You have 
no choice but to tell them they have to 
stay awake and alert through it all. But a 
student can lose interest wading through 
so much familiar material in wait of that 
occasional gem of new information. 

Here are some more subtle differences 
that a C programmer might miss by skip- 
ping over the basics. 


e A void pointer in C++ cannot be as- 
signed to a pointer to a type without 
a cast. 

e The C++ main function cannot be called 
recursively in a C++ program. C has no 
such restriction, although it probably 
should. 





e You must initialize a const object in C++. 

e Variables cannot be implicitly declared 
as int. 

e An enumerator is a type, not an int. 

e wchar_t and bool are real types, not 
typedefs. 

e floats are not always promoted to dou- 
bles in expressions. 


As an author, I’m not sure I can solve 
the problem of a reader’s attention span 
in such a book— short of putting those 
eye-catching, tacky Dummies-like icons 
in the margins: “Stop!” “Look here!” “Im- 
portant!” “New stuff!” “Wake up!” Such a 
practice would ruin my book’s chances 
of becoming a respected textbook in the 
hallowed halls of higher learning. Wait a 
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minute! What am I saying? What faculty 
in its right mind would adopt into its cur- 
riculum a textbook titled Teach Yourself 
anything? The students and the adminis- 
tration would ask the teachers, “What do 
we need you for?” Now I know why I 
don’t like that title. 

Believe it or not, the much maligned 
goto flow-control statement works quite 
differently in C++ than it does in C. You 
might wonder why they bother fixing 
goto when everyone tells everyone else 
not to use it. But goto, as permitted in 
C, would have a dangerous side effect 
in C++. Consider Example 1, which is 
valid C code and invalid C++ code. C++ 
does not permit gofo to jump around the 
initialization of an automatic object, 
which could bypass a necessary con- 
structor. 


Class == Structure ? Not : Almost 

C++ defines structures and classes almost 
identically. The only differences are re- 
lated to access specifiers and inherited ac- 
cess. The members of a structure have 
public access by default. The members of 
a class have private access by default. 
Classes derived from a structure are de- 
rived publicly by default. Classes derived 
from a class are derived privately by de- 
fault. If you didn’t already know that, then 
go buy my book. Please? 

This is not a difficult concept to ex- 
plain when you are teaching C++ to a C 
programmer. You can ignore structs for 
a while and teach the behavior of class- 
es. When the student understands class- 
es, you can reveal the surprise that structs 
and classes are almost identical with the 
only differences being those I just ex- 
plained. The C programmer has no prob- 
lem with that. In fact, many C program- 
mers are never taught that structures and 
classes are alike, and they program for 
years believing that C++ structs are just 
like C structs with no member functions, 
access specifiers, or participation in in- 
heritance. 

But when you are teaching C++ from 
scratch, the question that begs to be an- 
swered is this: Why have two different 
constructs when the differences are so 
small? I suppose you could ignore 
structs, but that would bypass necessary 
information; the programmer is bound 
to encounter them in C++ programs writ- 
ten by others. The only way to under- 
stand the reasons for the two is to un- 
derstand that C++, as it strives for 
compatibility, inherits a lot of language 
from C. Which means that you must 
teach not only the origins and history of 
C++, but the consequences of all that 
legacy baggage, too. 

The answer to the class versus struct 
question goes back to when the C++ class 
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was evolving from the C struct. There is 
no real technical reason why the C++ 
struct should include all the properties 
of the class. C++ cannot eliminate the 
struct altogether; it must support the C 
struct to preserve compatibility between 
the languages according to Bjarne Strous- 
trup’s original objectives for the C++ lan- 
guage. But without an explanation from 
Stroustrup, it is not clear why the struc- 
ture needs member functions, access 


Many C 
programmers are 
never taught that 

structures and 
classes are alike 


specifiers, and the ability to participate 
in class hierarchies. In The Design and 
Evolution of C++, (Addison-Wesley, 1994), 
Stroustrup says: 


My intent was to have a single concept: a 
single set of layout rules, a single set of 
lookup rules, a single set of resolution rules, 
etc....Only a single concept would support 
my ideas of a smooth and gradual transi- 
tion from “traditional C-style programming,” 
through data abstraction, to object-oriented 
programming. 


So, the reason is cultural rather than 
technical. Stroustrup goes on to explain 
that keeping the class and struct the same 
forestalled an otherwise unavoidable ten- 
dency on the part of language standard- 
izers and specifiers to overwhelm the class 
specification with excess features while 
leaving the struct to implement only those 
features that involve low overhead and 
simplicity. 

Given all that, when should you use a 
struct rather than a class? Or should you 
ever? Many programmers adopt this rule: 


When the data structure’s implementation 
is the same as its interface, use a struct. 
Otherwise use a class. 


What are the implications of this rule? 
What does it mean when you say that 
the implementation is the interface? I de- 
veloped the strategy several years ago 


for my own programs, but I never heard 
it expressed so well. I got the phrase 
from Ruminations on C++ (Addison- 
Wesley, 1997), by Andrew Koenig and 
Barbara Moo. This is a nice book with 
cover art that hides some surprises. At 
first it looks like the cover for a paper- 
back edition of The Yearling or Huckle- 
berry Finn. Then, because of the black 
and white cows, the book looks like a 
Gateway 2000 manual. Why the cows, I 
wondered. Then it hit me— one of the 
authors is named “Moo.” Then I re- 
membered that “ruminating” means 
“chewing cud” as well as thinking about 
stuff. The book is an edited collection 
of Koenig’s columns in various publica- 
tions related to C++. Although some of 
his ruminations are dated (Old cud?), re- 
flecting their age and the technology as 
it existed when he wrote them, this book 
is well worth a careful read. I highly rec- 
ommend it. 

Saying that a struct’s implementation is 
its interface means simply the struct is typ- 
ical C with data members only (no mem- 
ber functions), all of which have public ac- 
cess so that the format of the data members 
is what the application program views. 

Object-oriented purists would contend 
that by following that rule, there is no valid 
application for the C++ struct. If you tend 
to fall into that camp, then C++ supports 
your beliefs. Use classes exclusively. If 
you lean more toward the pragmatic ap- 
proach, then C++ permits you to write 
code by using either idiom. C++ has some- 
thing for everyone. 


C=C > C++ ?C: C++ 

C++ is sometimes called a superset of C, 
which makes C a subset of C++. Except 
that Standard C came first. C++ has been 
called an object-oriented extension of C, 
but that doesn’t seem to work either be- 
cause, as I learned, the C that C++ sup- 
ports is not the C that Standard C com- 
pilers support. If you can forget about 
the chronology, perhaps the best de- 
scription of the relationship between the 
two languages can be expressed like this: 
If you are comparing Standard C to C++, 
they are two different languages. The C 
component of C++ and the programming 
models that it supports are different 
enough from Standard C to set them 
apart. If you are addressing the C com- 
ponent that C++ compilers support, per- 
haps the best way to describe it is as a 
dialect of C++, one that enjoys certain 
notational improvements over Standard 
C and leaves out the data abstraction and 
object-oriented idioms. Stroustrup’s “bet- 
ter C.” C as a dialect of C++. What a pe- 
culiar notion! 


DDJ 
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JAVA Q&A 


How do | Write an 
International Application? 


(litt Berg 


he Internet has opened up the world 

to computing. Simply by using 

e-mail, or transferring/hosting soft- 

ware on the Web, it becomes as easy 
to work with people on the other side 
of the globe, as it is to work with peo- 
ple on the other side of town. Java helps 
makes this possible because it is a net- 
work-capable language. International 
companies want to take advantage of 
this boundless computing model, and 
write applications that customers and a 
global workforce can access anywhere — 
in any language. 

Java is touted as a multilanguage- 
capable computer language because it 
provides built-in support for Unicode. This 
is not enough, however, for true multi- 
language support. There also needs to be 
support for displaying monetary curren- 
cies, and foreign number, date, and time 
formats. It would also be nice if multi- 
language support was easy to implement, 
without hardcoding of language-specific 
strings. JDK 1.1 provides a suite of pack- 
ages for multilanguage and multinational 
development. While I won’t get into all of 
the features of those packages here, I will 
show how to use some of the more im- 
portant ones. 


Locales, Resources, 

and Resource Bundles 

JDK 1.1 introduces the term “locale’— a 
specification of any of spoken language, 
geographic location, and additional qual- 
ifiers that may be built-in. Generally, a lo- 
cale can be, for example, the combina- 
tion “English” and “England,” or “English” 


Cliff, vice president of technology of Digi- 
tal Focus, can be contacted at cliffbdf@ 
digitalfocus.com. To submit questions, 
check out the Java Developer FAQ web site 
at http://www .digitalfocus.com/fad/. 
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and “Australia.” A locale need not speci- 
fy everything: The resource that most 
closely matches the specification is used, 
and if none matches, resources for a de- 
fault locale are used. 

The new JDK 1.1 resource mechanism 
(in the package called “util”) is the foun- 
dation for the internationalization facili- 
ties. Resources are location-independent 
collections of information that may be re- 
trieved by name. They relocate automati- 
cally with the program no matter how it 
is deployed. A resource can be an image 
file, text string, or any Java object. It may 
be stored in a property file or as a stream 
of bytes. 

The key feature of a resource is that it 
is designed to follow the application. It 
may be encapsulated into a JAR file, for 
example. Regardless, it is always accessed 
the same way—with the class loader’s get- 
Resource() method. (A Class object also 
has a getResource() method, but it mere- 
ly calls the getResource() method of the 
class loader that loaded the class.) 

A ResourceBundle is a collection of re- 
sources specifically designed to aggregate 
those resources needed for a specific ge- 
ographic locale or spoken language. A 
naming convention serves to identify 
specific-resource bundles according to 
their locale, so that the resource-bundle 
methods know which resource bundle to 
select, based on the current locale. A lo- 
cale can be set on a per-object basis, as 
opposed to a system-wide basis, making 
it possible to deal with more than one lo- 
cale at a time. This is important, for ex- 
ample, for multilanguage programs, such 
as language translators. 


The Calculator Class 

Figures 1 and 2 show multilanguage desk 
calculators that let you select from one 
of two languages (German and English), 





and one of two modes (Standard and 
Currency). Whenever one of these se- 
lections is changed, the calculator re- 
configures itself accordingly. For ex- 
ample, when German is selected as the 
language (as in Figure 1), control labels 
are displayed in the German language. 
If mode is set to Currency, numeric 
values are displayed as currency val- 
ues, either in dollars or Deutschmarks, 
depending on the language selected. 
Figure 2 shows an English version of 
the calculator. 

The calculator class (available elec- 
tronically; see “Availability,” page 3) is im- 
plemented as an applet, since one use of 
an international program is as a browser- 
based application. Since JDK 1.1 is re- 
quired, browsers that have not yet imple- 
mented JDK 1.1 will not be able to run it. 
At this writing, HotJava and Appletview- 
er support JDK 1.1. 

The first thing the applet does is in- 
stantiate all of its GUI components in its 
init() method. Since this is a 1.1 appli- 
cation, each component specifies an 
event handler (an ActionListener or Item- 
Listener, in this case). For simplicity, I 
have chosen to put all of the event- 
handling behavior in the applet, so the 
applet implements both ActionListener 
and ItemListener. The init() method then 
calls updateGui(), which obtains the re- 
sources needed to support the new set- 
tings, then redisplays the applet with 
those settings and resources. This method 
is also called whenever users reconfig- 
ure the applet by changing the language 
selection, or the calculator mode. 

The first thing updateGui() does is call 
getLocaleSetting(). This method gets the 
user’s language selection by comparing 
the text of the language-choice selection 
with the built-in language name string for 
each of our two supported languages. 
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Applet started. 


These are the same strings used when 
building the language-choice control, so 
one should match the user’s selection. 
When a match is found, the private vari- 
able “locale” is set to the corresponding 
built-in locale. (There are presently 28 
built-in locales.) getLocaleSetting() then 
gets the resource bundle for the locale by 
calling the static method java.util.Re- 
sourceBundle.getBundle( “ButtonLabel- 
Resources”, locale). This method attempts 
to locate the ButtonLabelResources re- 
source bundle for the specified locale. A 
resource bundle can be a property file or 
Java class. I have chosen to use a prop- 
erty file in this case. Un fact, there are 
two property files—ButtonLabelRe- 
sources.properties, and ButtonLabel- 
Resources_de properties.) The getBundle() 
method uses the convention “<bun- 
dle_name>_<language>_<country>.prop- 
erties” to identify a resource file, and 
since “de” identifies German, the Ger- 
man language resource bundle will auto- 
matically be loaded. I could have speci- 
fied a country (there are currently three 
German-speaking countries defined), but 
chose not to, so only the language will 
be used as a resource selection criteria. 
(At this writing, the supported locales are 
listed at http://www .javasoft.com/prod- 
ucts/jdk/1.1/intl/html/intlspec.doc2. html.) 
Finally, getLocaleSetting() sets the cur- 
rent locale to be the one that the user 
has selected. 

The updateGui() method makes the 
calls in Listing One (listings begin on page 
116). To understand these lines, look at 
what is contained in the aforementioned 
properties files. The standard properties 
file (the one without _de in its name) con- 
tains Listing Two. Thus, three properties 
are specified. If the system chooses this 
properties file when it searches for the 
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Figure 1: Calculator applet set up for German currency. 
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ButtonLabelBundle resource bundle, it will 
get these values. If on the other hand it 
chooses the German resource bundle, 
contained in ButtonLabelBundle_de.prop- 
erties, it will get the values in Listing Three. 

The first line contains a Unicode- 
escaped character sequence, which rep- 
resents the German word for currency 
(Wahrung). If I had a German-language 
Unicode-based editor, I could have typed 
this word in directly, without resorting to 
the escape sequence. 

The first line in each property file is, 
therefore, the label that is to be used on 
the radio button that the user clicks when 
selecting currency mode. When German 
is selected as the locale, this is displayed 
in German; when working in English 
mode, the word “Currency” is displayed. 

The second line is the label to use for 
the other radio button, which selects non- 
currency, or Standard mode. Since the Ger- 
man adjective for “standard” is the same 
as the English word “standard,” the sec- 
ond line in each file is identical. The last 
line in each file specifies a GIF filename, 
which is loaded by Listing Four. 

I get the name of the file resource 
from the resource bundle, then use that 
name to find the actual resource — the 
file. I then request a repaint. Since my 
paint() method draws the imageURL ob- 
ject on the applet, I effectively have a 
different image drawn for each language 
selection. Note that I display the select- 
ed country’s flag. 

Finally, updateGui() makes the calls in 
Listing Five in which the first line sets a 
format- object reference depending on the 
state of the mode checkboxes. A format 
object (in the package called “java.text”) 
can be one of several kinds of object that 
act as input and output formatting services 
(conceptually similar to the way C- 


@ Standard 


Currency. 





Figure 2: Calculator applet set up in English. 


formatted I/O functions work— although 
better thought out). I use a numeric for- 
matter when the mode is Standard, and a 
currency formatter when the mode is Cur- 
rency. Note that specifying the locale is 
sufficient for the formatter to know how 
to format numbers and currency amounts 
uniquely for each locale. In many Euro- 
pean countries, thousands are separated 
with periods, and the decimal point is dis- 
played with a comma— exactly the re- 
verse of the standard practice in the U.S.) 
The formatting is even smart enough to 
know that the German currency is 
Deutschmarks, but alas, not smart enough 
to call an online currency-exchange ser- 
vice to get the going conversion rate. List- 
ing Six is the code the runs the applet. 

The complete source code for the ap- 
plet is available electronically (see “Avail- 
ability,” page 3) and at the Digital Focus 
web site (http://www.digitalfocus.com/ 
ddj/code/). 


Conclusion 

The internationalization resource mecha- 
nisms provided by JDK 1.1 are not only 
flexible and powerful, but extremely easy 
to use. There are a large number of meth- 
ods, only a few of which I’ve touched on 
here. Do not be intimidated, however, be- 
cause the API is well thought out and sim- 
ple to understand. Furthermore, once you 
get used to the resource mechanism, you 
will find that it makes keeping track of 
images and other items used by a pro- 
gram much easier. You'll be able to pack- 
age resources into a JAR file with your ap- 
plet and not have to worry about whether 
the applet can find them. 


DDJ 
(Listings begin on page 116.) 
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Will Schroeder and Tom Citriniti 


omputer- generated, interactive 3-D 

graphics is growing in importance 

and application. Many games and 

even sophisticated user interfaces 
are based on 3-D graphics technolo- 
gy. For example, Doom and Quake use 
3-D graphics in combination with tex- 
ture maps to create vivid, adrenaline- 
producing games. Web-based technolo- 
gy, such as VRML, enables users to fly 
through virtual worlds or interact with 
databases. The use of 3-D graphics is 
likely to explode as new software tools 
and graphics accelerators are introduced 
into the marketplace. 

Unfortunately, a limiting factor in the 
use of 3-D graphics is the amount of data 
that must be processed, transmitted, and 
rendered. In our work environment, we 
bump into this limitation regularly: One 
of our applications involves visualizing 
the internals of aircraft engines and oth- 
er mechanical devices. In this environ- 
ment the database ranges in size from 
10-100 million triangles, with the desired 
goal of flying through the data at 3-30 
frames per second. You may have ex- 
perienced similar limitations if you’ve 
ever tried to use VRML applications or 
to view VRML content on the Web. Many 
of these applications are far from inter- 
active. 

To address this problem, a relatively 
new field has emerged in computer 
graphics, often referred to as “triangle 
decimation” or “polygon reduction.” The 
aim of these techniques is to reduce the 
number of polygons in a mesh while 
maintaining a good approximation of the 
original data. The focus of these algo- 
rithms is on polygons— especially trian- 
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gles— because 3-D graphics accelerators 
are designed to process these geometric 
primitives. Triangles are used because 
surface primitives, such as polygons or 
splines, are triangulated before being 
handed off to the graphics hardware. 
In this article, we will focus on a dec- 
imation algorithm that is fast, widely used, 
and for which source code is available. 
We will also show how it is used, and 
how to create a decimated VRML file. 


Polygon Reduction Algorithms 
Polygon reduction algorithms can be clas- 
sified in two ways: whether they modi- 
fy the geometry of a mesh, and whether 
they modify the topology of the mesh. 
When we say “mesh geometry,” we mean 
the x-, y-, and z-coordinates of the ver- 
tices, while mesh topology refers to fea- 
tures like holes or handles (imagine a 
torus). Algorithms that modify the ge- 
ometry of a mesh will create new ver- 
tices, or possibly move existing vertices 
to new positions. The advantage of mod- 
ifying geometry is that vertices can be 
repositioned to give a better approxima- 
tion of the original mesh. The disadvan- 
tage is that if attribute information like 
texture coordinates or color is associat- 
ed with the vertices, it must be mapped 
to new values when the vertex location 
changes. Unfortunately, both the calcu- 
lation of new vertex positions and at- 
tribute mapping tend to be expensive op- 
erations. 

Algorithms that modify topology will 
close holes (imagine removing rivet 
holes in sheet metal), add holes or split 
the mesh, or even introduce nonmani- 
fold attachments. An example of a non- 
manifold edge is an edge shared by three 
or more triangles, rather than the usual 
two (interior edge) or one (boundary 
edge). 

Most polygon reduction algorithms will 
preserve the topology of a mesh, but it 





is common to modify the mesh geome- 
try. The decimation algorithm described 
here preserves both the geometry and 
topology of a mesh. 


The Decimation Algorithm 

The decimation algorithm performs a se- 
ries of local operations on a mesh to 
eradually reduce the number of triangles 
and vertices. These operations are per- 
formed until the desired reduction is 
achieved, or until no more operations are 
possible due to topological or other con- 
straints. As Figure 1 illustrates, there are 
three major steps in the process: 


1. Classify a vertex according to its local 
geometry and topology. Classification 
also involves estimating the potential 
error introduced into the mesh if the 
vertex is deleted in steps 2 and 3. 

2. Delete the vertex if it is of appropri- 
ate classification and if its error mea- 
sure is less than some threshold val- 
ue. Vertex deletion causes the removal 
of all triangles using the deleted ver- 
tex, and results in a “hole” in the mesh. 

3. Patch the hole with a new triangula- 
tion. The net effect is two fewer trian- 
gles if the vertex is in the interior of the 
mesh; or one less triangle if the vertex 
is on the boundary. 


The classification of a vertex depends 
upon both the local geometry and topol- 
ogy. For example, vertices that have an 
edge that is used by more than two tri- 
angles are considered nonmanifold. This 
is a topological classification. Feature 
edges are used for geometric classifica- 
tion. Feature edges are found when the 
normals of the two triangles on each side 
of the edge form an angle greater than a 
user-specified feature angle. 

Vertex classification is important be- 
cause, if done correctly, it can help pre- 
serve sharp edges and corners (edges 
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and corners of a cube, for example). Fea- 
ture edges are identified and the trian- 
gulation of the hole is controlled to pre- 
serve these sharp edges. Also, certain 
vertices, like nonmanifold vertices, are 
not deleted to ensure that the topology 
of the mesh is not modified. 

An important feature of this algorithm 
is how the error is estimated. One sim- 
ple measure of error is computing the 
distance from the original mesh to the 
decimated mesh after vertex deletion (es- 





sentially a measure of distance to plane). 
Obviously, if the triangles around a ver- 
tex all lie in the same plane, then the 
deletion of the vertex introduces no er- 
ror. Or, if the vertex lies on the bound- 
ary of the mesh, the error measure is the 
distance of the new mesh edge to the 
deleted vertex (distance to edge). For 
more information on this algorithm, see 
“Decimation Of Triangle Meshes,” by WJ. 
Schroeder, J. Zarge, W. E. Lorensen, Pro- 
ceedings of Siggraph 91. 


Figure 1: Overview of the decimation algorithm. 





decimated part 83 percent reduction. 
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Figure 2: Decimation of a CAD part: (a) Original part shown flat shaded; (b) 








Applications 

To demonstrate the application of deci- 
mation, we'll use the Visualization Toolk- 
it (vtk) available at http://www.cs 
pi.edu/~martink/. Vtk is a C++ class li- 
brary with a built-in Tcl/Tk interpreter 
for visualization and 3-D graphics, and 
includes source code, data, and many ex- 
amples. The software runs on UNIX and 
Windows 95/NT. For more information, 
refer to The Visualization Toolkit: An Ob- 
ject-Oriented Approach to 3-D Graphics, 
by Will Schroeder, Ken Martin, and Bill 
Lorensen (Prentice-Hall, 1996 ). [Editor’s 
Note: The Visualization Toolkit was re- 
viewed in “Programmer’s Bookshelf,” 
DDJ, June 1997.] 

In our first example, we'll decimate a 
CAD part that consists of 11,036 trian- 
gles. Listing One (listings begin on page 
116) is the Tcl script that creates the re- 
sults in Figure 2. Note that vtk uses a 
dataflow approach, or series of filters, to 
process the data. The first filter is a 
stereo-lithography reader. (Stereo lithog- 
raphy is a 3-D triangle format for read- 
ing and generating 3-D plastic parts.) 
Then, the decimation filter processes the 
triangles. Finally a mapper is connected 
to an actor, which represents the object 
in the rendered scene. The decimator is 
able to reduce the number of triangles 
to 1876, a total reduction of 83 percent. 
Note that the surface is rendered flat 
shaded to exaggerate the effects of the 
decimation. 

An instance of the uvtkDecimate class 
in Listing One is inserted into the visu- 
alization pipeline immediately after the 
reader object. Three important attributes 
to this class are the TargetReduction, Er- 
rorIncrement, and Maximumlterations 
instance variables. TargetReduction spec- 
ifies the reduction level desired. The al- 
gorithm attempts to meet this level of re- 
duction, but, in some cases, topology 
limitations or error limits prevent it. The 
ErrorIncrement ivar is the amount the al- 
lowable error is incremented each itera- 
tion of the algorithm. Finally, the Maxi- 
mumiterations limits algorithm execution 
in case the requested reduction cannot 
be achieved. 

In the next example, we'll decimate a 
range image derived from a 3-D Cyber- 
ware laser digitizer. The digitizer can gen- 
erate meshes of 1 million triangles in 
15-30 seconds. It also captures the col- 
or of the surface which is applied as a 
texture map. (The data shown is a scan 
of our friend Fran’s face when he hap- 
pened to wander into the lab one day.) 
Figure 3(a), the original mesh, consists 
of 52,260 triangles, while Figure 3(b), the 
final one, consists of 2562 triangles— a 
95 percent reduction. Figure 3(c) shows 
the edges of the triangles. In the original 
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(continued from page 110) 

mesh, the edges were so dense that even 
a wireframe rendering of the surface ap- 
peared solid. Listing Two is a Tcl script 
that creates the images. 

This example demonstrates the ability 
of surface texture to hide low-resolution 
geometry. Most interactive games make 
extensive use of texture to add detail to 
images. In fact, many 3-D graphics 
boards available on the PC are targeted 
toward low polygon count/textured sur- 
faces. These boards do not perform well 
when the polygon count becomes large, 
since point transformation is often not 
accelerated. 

In our final example, we'll parse a 
VRML 1.0 file, decimate the geometry, 
and then export the geometry using the 
vtRVRMLExporter. The parser was built 
using the QvLib parsing code developed 
by Gavin Bell and Paul Straus of SGI. The 
code currently reads in a VRML 1.0 file 
and creates an in-memory scene graph 
of the geometry. The system will deci- 
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Figure 3: Decimation of CAD part: (a) original Cyberware data; (b) 95 percent reduction; (c) triangle edges. 


mate any IndexFaceSet geometry nodes 
that exist in the file by placing a vtkDec- 
imate object in the final rendering 
pipeline. The system then collects all ge- 
ometry nodes, triangles and others, dis- 
plays the resultant decimated geometry 
and outputs a VRML 2.0 file if specified 
on the command line. 

The main function of the system is to 
translate the VRML scene graph into an 
object-oriented vtk scene. The translation 
encapsulates the scene graph by moving 
properties and transforms from hierar- 
chical scene graph dependencies into en- 
capsulated object pointers. This allows 
objects to implicitly represent themselves 
to external manipulators, an important 
feature for large-scale object systems that 
have many objects with multiple manip- 
ulators. 

As these IndexFaceSet nodes are ren- 
dered in the object-oriented model, the 
decimate object takes the original trian- 
gles and outputs the decimated equiva- 
lent. Other shape nodes, such as Cones 


Figure 4: Decimation of VRML part: (a) original VRML data; (b) decimated 
VRML data. Total reduction is 70%. 








and Cubes, are ignored since the brows- 
er is responsible for generating an opti- 
mal rendering solution for the specific 
shape. 

Testing has shown that some VRML 
polygonal models can be reduced by 
20-60 percent with little apparent visu- 
al change. Decimation can be used to au- 
tomate the generation of multiple repre- 
sentations of an object for the VRML level 
of detail node. The result of one deci- 
mation is in Figure 4, which shows the 
original and decimated versions in SGI’s 
Cosmo VRML viewer. 

You can find the VRML decimator code 
at http://www.rpi.edu/~citrit/, plus ad- 
ditional examples and results. There are 
options to set parameters for the deci- 
mation algorithm via the command line. 
The code is available as a C++ distribu- 
tion and requires vtk to be preinstalled. 
If you do use the VRML decimator, you 
will need a VRML browser to view the 
resulting models. 


Conclusion 

Triangle decimation algorithms play an 
important role in maintaining the re- 
sponsiveness of 3-D graphics systems. 
By reducing data size, these algorithms 
minimize the amount of data to be stored 
on disk or in memory, transmitted across 
the network, and rendered by the graph- 
ics system. By compressing 3-D graph- 
ics data using triangle decimation, you 
can often squeeze out the last ounce of 
performance, which can make the dif- 
ference between an engaging interactive 
system or one that annoys users. 


DDJ 
(Listings begin on page 116.) 
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In-Grcuit Emulation 
A powerful hardware tool for software debugging 


Robert R. Collins 


_ launched a three-article discussion of 
_ Intel’s System Management Mode (SMM) 
__ a few months ago with a comparison 
= Of the 80386’s In-Circuit Emulator (ICE) 
support and System Management Mode 
(see DDJ, January 1997). Those columns 
provided more information about in-cir- 
cuit emulation than I’ve seen in print in 
any other forum. Nevertheless, in- 
circuit emulation remains a mystery to most 
people. Engineers are spending scores of 
hours using arcane debugging techniques, 
simply because they don’t know that a bet- 
ter, more powerful way exists to debug 
their toughest problems. The most com- 
mon questions I am asked are: what is it? 
how much does it cost? what can it do? 
and what are the limitations? These are 
some of the questions I will attempt to an- 
swer in this column. I'll discuss the basics 
of in-circuit emulation, and the history of 
Intel’s in-circuit emulator designs. In the 
coming months, I will discuss the micro- 
processor in more detail, as well as how 
it is designed with in-circuit emulation in 
mind. Finally, I will conclude the series by 
demonstrating some of the debugging tech- 
niques I’ve developed for use with in-cir- 
cuit emulators. 





My Own ICE History 

My first experience with in-circuit emula- 
tion came as a junior-level BIOS engineer 
at Tandon Computers. I believed that I 
could solve any debugging problem us- 
ing Microsoft Codeview. To me, Codeview 
represented the pinnacle of source-level 
debuggers. It let you set breakpoints and 
step through code execution in source or 
assembly-language mode. Breakpoints are 
set when Codeview surreptitiously inserts 
an INT-3 (breakpoint interrupt) into the 
code stream. The INT-3 insertion is hid- 
den from the user when viewing in as- 
sembly mode, but the opcode can be de- 
tected when viewing raw memory. When 
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the breakpoint occurs, Codeview regains 
control and the user can view and modi- 
fy the CPU registers, memory contents, 
and other program variables. This tech- 
nique works fine when your program is 
in volatile memory (RAM). However, it 
never works when the program resides in 
read-only memory (ROM)— like the ROM 
BIOS. Obviously, Codeview cannot insert 
an INT-3 into the code stream of a ROM 
BIOS, because the ROM cannot be writ- 
ten. This is where the in-circuit emulator 
begins to help. 

I was forced to start using an in-circuit 
emulator when I was given a problem that 
occurred in the ROM BIOS before the 
computer booted the operating system. 
Codeview and other debuggers can’t run 
without first booting an operating system. 
Therefore, I knew that I couldn’t use 
Codeview to help me debug this problem. 
My only alternative was to learn how to 
use the ICE. I cringed because I was 
scared to death of this monstrous ICE. In 
reality, I was afraid of learning something 
new. In fact, it didn’t take long to learn 
how to use it; I actually liked it. The ICE 
was so powerful and versatile that I nev- 
er looked back. 

That was eight years ago. Today, I use 
an ICE for almost all my debugging. In 
many cases, a software-based debugger 
is still more productive than an ICE. How- 
ever, over the years, I have honed my ICE 
debugging skills. Today, in those cases 
where a software debugger may have a 
productivity edge, my ICE skills often 
make up for the difference, giving me vir- 
tual parity in either environment. 


In-Circuit Emulators versus 
Source-Level Debuggers 

Modern in-circuit emulators share many 
attributes with software-based debuggers. 
Both support source-level debugging, soft- 
ware breakpoints, and memory watch 
points. You may reference or modify vari- 
ables by name, or disassemble modules 
and subroutines by name and line num- 
ber. Both allow you to view or modify raw 





memory. Both give the ability to view and 
modify source code at the assembly-lan- 
guage level. 

Even though ICEs have many of the 
same capabilities as software debuggers, 
they aren’t without their limitations. Some 
ICEs support source-level debugging by 
loading executable programs (.EXE files) 
directly into memory, albeit without 
source-level debugging information (like 
line numbers and symbol tables). Even 
though Microsoft Codeview is the de fac- 
to standard for software debuggers, Intel 
never supported the loading of an exe- 
cutable file that was compiled with Code- 
view debugging extensions. Instead, In- 
tel’s ICEs only supported source-level 
debugging by loading object modules 
(.OMF files) directly into memory. The In- 
tel OMF files were a pseudoproprietary 
format— clearly not an industry standard. 
If you wanted to convert your .EXE files 
(with Codeview information) into .OMF 
files (with Intel debug information), you 
needed an $800 software package called 
“Link & Locate 386 Extended Edition,” 
from Systems & Software Chttp://www.ssi 
.com/). Thankfully, Intel has exited the 
ICE business, allowing other ICE vendors 
to depart from their (backward) lead. To- 
day, ICE manufacturers are starting to sup- 
port source-level debugging in standard 
Microsoft (.EXE) formats. As far as I’m con- 
cerned, this limitation (along with the hefty 
price tag) is the worst limitation of us- 
ing in-circuit emulators for every day de- 
bugging problems. 

In all other ways, an in-circuit emulator 
is much more powerful than any software- 
based debugger. Breakpoints may be set 
anywhere in a program, regardless of the 
memory type (RAM or ROM). Breakpoints 
can also be set on certain bus events that 
cannot be detected by any source-level de- 
bugger. Consider the following breakpoint 
events, and ponder using a standard de- 
bugger to do the same thing: 


e Break upon any memory access (read, 
write, or either) at a specific address, 
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with specific data. 

e Break upon any memory access at a pat- 
tial don’t-care address, like 00124XXX 
with partial don’t-care data such as 
XX2345XX. 

e Break upon data access (memory or I/O, 
but not code fetches) to a specific ad- 
dress, or an address and data with don’t- 
care fields. 

e Break upon any byte, word, or double- 
word memory or I/O access at any 
address. 

e Break upon any microprocessor spe- 
cial cycle, such as INT-Acknowledge, 
FLUSH, or a CACHE WRITEBACK. 

e Break upon an interrupt acknowledge 
cycle for a specific interrupt, or any ar- 
bitrary interrupt. 

e Break upon bus inactivity or ADS hold 
violations. 

e Break upon code fetches with specific 
data patterns. 

e Even break upon certain illegal bus cy- 


cle types. 


The ICE has the ability to halt emula- 
tion on any of these events, and many 
more that don’t readily come to mind. 
These capabilities are all accomplished 
with hardware assistance, which doesn’t 
exist in software-based debuggers. This 
extra hardware assistance gives the ICE 
its powerful capabilities, but also gives it 
a hefty price tag. The traditional hardware- 
assisted ICE costs between $35,000 and 
$50,000. Other scaled-down versions, 
called In-circuit Test Probes (ITPs) or In- 
Circuit Debuggers (CDs), lack the hard- 
ware assistance, but cost under $10,000. 
(I will discuss the differences between 
ICEs and ITPs in my next column.) 

ICEs also support debugging symmet- 
ric multiprocessor (SMP) environments. 
The ICEs have the ability to chain together 
and signal each other when one proces- 
sor receives a breakpoint event. This abil- 
ity gives the ICE the clear advantage in 
debugging any SMP problems. 

In truth, the term “emulator” is actual- 
ly a misnomer. The ICE is not emulating 
anything — it’s a real CPU that is plugged 
directly into the CPU socket. The ICE just 
happens to have a hundred-wire umbili- 
cal cord attached to it. For the most part, 
the ICE runs at the full CPU speed. There- 
fore, those hard-to-find race conditions 
between software and hardware will still 
show up using an ICE. 


ICE Evolution: Intel’s Offerings 

The first ICE I used was a dedicated in- 
circuit emulator computer from Intel. I 
called this “the big blue box” type of 
ICE. The entire ICE was housed in a self- 
contained computer, which included a 
monitor and keyboard. The ICE plugged 
into the CPU socket, and targeted a 6-MHz 
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80286 motherboard. Execution breakpoints 
were detected by snooping code prefetch- 
es on the microprocessor data bus. When 
a code prefetch matched your specifica- 
tion, the ICE would halt. Then, you could 
examine or modify memory, CPU regis- 
ters, memory, and I/O ports. 

Later, Intel introduced the I2ICE, a de- 
parture from the dedicated ICE machine 
approach. Users needed to provide a host 
computer, which typically needed to be an 
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are much more 
powerful than any 


software-based 
debugger 


80286-class machine with some amount of 
expanded memory. (Yes, that’s right. ..LIM- 
style expanded memory.) If your comput- 
er didn’t have expanded memory, Intel 
would sell you an above-board unit to 
serve this purpose. The host computer at- 
tached to the I2ICE hardware via a stan- 
dard serial connection— communicating 
at the lightning speed of 9600 baud. The 
I2ICE hardware was in a box approximately 
30X24x10 inches in size (if memory serves 
me correctly). The most noticeable attribute 
about the I2ICE was its noise— the hard- 
ware had a fan on it that was very loud, 
making it hard to work in close proximity 
to this unit. 

The I2ICE hardware had a limited set 
of changeable CPU modules. I recall hav- 
ing an 8086/8088, and an 80286 CPU mod- 
ule for our I2ICE. I also seem to recall that 
an 80186/80188 module was also avail- 
able. Emanating from one end of the I2ICE 
hardware was a lead-shielded cable (the 
CPU umbilical cord), while at the other 
end was a small hardware module that 
plugged into the CPU socket. The real 
CPU laid on top of this small module (in 
close electrical proximity to the mother- 
board). Adapters were available to switch 
between CPU form factors— for example 
PLCC and PGA versions of the 80286. 

With the next evolutionary change, the 
huge (and loud) I2ZICE hardware was 
gone. In its place was a small, streamlined 
box that measured approximately 15x12x2 
inches. This ICE was commonly called the 
“hot-plate” or “boiler-plate” ICE because 





of its appearance. The host computer 
plugged into this small box, which in turn 
plugged into a small module that housed 
the CPU. Like the I2ICE, this ICE targeted 
multiple microprocessor environments. 
Modules were available for the 80286, and 
the newly released 16-MHz 80386. 

About this time, Intel dabbled in UNIX- 
based ICEs. At one point, it shipped an 
ICE that was UNIX-software based. Instead 
of requiring a host computer, a VT-100 ter- 
minal was needed. Once the hardware 
booted UNIX, the ICE host autostarted it- 
self. I’m only aware of an 80386 version 
of this ICE, though I wouldn’t be surprised 
if other microprocessor targets were avail- 
able. My most remarkable ICE story (the 
discovery of five or six undocumented op- 
codes) involved using this orphan ICE en- 
vironment. This UNIX-based ICE disas- 
sembled all of the undocumented opcodes 
on the 80386 microprocessor. This inad- 
vertent mistake gave me all of Intel’s in- 
ternal names for these undocumented op- 
codes. After I reverse-engineered the 
functions of these opcodes, I published 
my findings at http://www.x86.org/se- 
crets/opcodes. This publication caused 
some concern within Intel’s legal depart- 
ment that I had stolen this information. I 
was more than happy to tell their lawyer 
that my discovery was the result of Intel’s 
sloppiness. 

As microprocessors got faster and faster, 
Intel was forced to keep redesigning its 
ICE hardware. The next evolutionary 
change occurred when Intel developed the 
“Cobra” ICE chassis. The Cobra chassis was 
small, measuring approximately 12x10x3 
inches in size. It was quiet and designed 
to target multiple microprocessor environ- 
ments. The Cobra chassis was a modular 
design and had boards that could plug in 
and out. When a new CPU was designed, 
you simply bought the two plug-in boards, 
and saved over $20,000 in hardware costs. 
The Cobra chassis supported the 80386 DX, 
80386 SX, and initial offerings of the 80486 
DX, 80486 SX, and 80487 SX. An optional 
high-resolution time-tag board could be 
purchased for an additional $1500. The 
time-tag board provided cycle-accurate 
time-stamp information to the ICE bus cy- 
cle traces. The option also required a math 
coprocessor (80387) be plugged into the 
host computer. With a whopping 38,000 
baud communications link, the Cobra was 
also much faster at communicating with 
the host computer. This higher baud rate 
substantially helped transfer microproces- 
sor traces from the Cobra chassis to the 
host computer. 

The Cobra chassis also supported func- 
tions for multiprocessor environments. Each 
Cobra chassis had two “SYNC” outputs and 
two “SYNC” inputs. These SYNC signals 
provided the means to start, stop, and trig- 
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ger multiple ICEs in a multiprocessor en- 
vironment. These signals could also be used 
to send and receive signals to and from ex- 
ternal devices. I often used these signals to 
trigger a logic analyzer or SCSI BUS ana- 
lyzer when the CPU detected a breakpoint. 
Conversely, I used the logic analyzer and 
SCSI BUS analyzers to trigger breaks to the 
ICE using these signals. 

Before Intel came out with the Cobra 
version of the 80486 ICE, they vowed that 
it couldn’t be done. Intel’s sales force told 
me that they couldn’t design an ICE that 
ran at such a fast CPU speed (33 MHz). In- 
tel promised us developers that the 80386 
ICE was the last of the standard, hardware- 
assisted ICEs. Instead, Intel introduced the 
80486 In-Circuit Debugger (ICD). The ICD 
didn’t support any of the fancy hardware 
breakpoint features of a full-blown ICE. 
The ICD breakpoint ability was limited to 
breakpoint events that were supported by 
the microprocessor itself. This included any 
debug register breakpoint, trap flag break- 
point, INT-1, task switches into a task with 
the T-bit set, writing to the debug registers 
when DR7.GD=1, and the undocumented 
ICEBP instruction (see http://www.x86.org/ 
secrets/opcodes/ICEBP.html for a descrip- 
tion of the ICEBP instruction). Without the 
hardware assistance, the ICD didn’t have 
an instruction trace. Even so, once a break- 
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point occurred, the ICD could disassem- 
ble assembly-language instructions, read 
and write memory, read and write I/O 
ports, and view all of the microprocessor 
registers — including the undocumented 
segment descriptor cache registers (see 
http://www.x86.org/articles/loadall/#SB1 
for a description of the segment descriptor 
cache registers). Even without hardware- 
assisted breakpoints or an instruction trace, 
the ICD was a very powerful debugging 
tool. As the first in-circuit debugging tool 
that cost under $10,000, the ICD was also 
a very cost-effective debugging solution. 
The final evolutionary change occurred 
in the same time frame that Intel abandoned 
designing and selling in-circuit emulators. 
Even though Intel abandoned the ICE mar- 
ket, they designed one last emulation de- 
vice to coincide with this final evolutionary 
change in microprocessor design. Intel had 
abandoned their current method of sup- 
porting in-circuit emulation functions with- 
in the CPU (available from the 80286 to 
80486), and adopted an entirely new ap- 
proach (available in the Pentium and Pen- 
tium Pro processors). This new approach 
was called a “debug port,” and required an 
entirely new emulator design. The new em- 
ulator design was called an “In-circuit Test 
Probe” (ITP). Like the ICD, the ITP didn’t 
have any hardware assistance. Without hard- 
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ware assistance, its debugging capabilities 
were identical to the ICD. The ITP was also 
a very cost-effective debugging tool, still 
costing less than $10,000. The ITP solution 
was both evolutionary and revolutionary. 
The ITP approach to in-circuit emulation is 
by far my favorite of Intel’s designs. 


Conclusion 

I have barely touched the surface of dis- 
cussing in-circuit emulation here. I’ve been 
using ICEs for eight years, and have a 
good understanding of how they work. I 
have watched Intel’s evolutionary changes 
to ICEs. During that time, ICEs have gone 
from dedicated hardware machines to a 
host-target environment. I’ve seen mon- 
strous ICE boxes and debuggers that are 
small enough to fit in your pocket. In my 
next column, I'll discuss the changes that 
took place in the microprocessors them- 
selves. In-circuit emulation wasn’t always 
provided by external hardware; consid- 
erable ICE support was designed into the 
CPU. I'll take a look at these changes and 
discuss their strengths and weaknesses. In 
another future column, I'll discuss the Pen- 
tium Probe Mode—ICE support built right 
into the Pentium Processor. 
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JAVA 


e e 
Listing One 
currencyCheckbox.setLabel (buttonLabelBundle. getString("CurrencyLabel") ) ; 
standardCheckbox. setLabel (buttonLabelBundle. getString ("StandardLabel") ) ; 


e e 
Listing Two 
CurrencyLabel=Currency 


StandardLabel=Standard 
FlagImage=us_flag.gif 


Listing Three 
CurrencyLabel=W\u@@e4hrung 


StandardLabel=Standard 
FlagImage=de_flag. gif 


e e 
Listing Four 
String imageName = buttonLabelBundle. getString("FlagImage") ; 


java.net.URL imageURL = getClass().getResource(imageName) ; 
image = getImage(imageURL) ; 


e e e 
Listing Five 
if (standardCheckbox. getState() ) 
format = java.text.NumberFormat.getInstance(locale) ; 
else 
format = java.text.NumberFormat.getCurrencyInstance (locale) ; 
setDisplayValue(); 


e e e 
Listing Six 
<html> 
<applet code="Calculator.class" width=325 height=25@> 
</applet> 
</html> 


ALGORITHM ALLEY 


Listing One 
catch {load vtktcl} 


# get the interactor ui 
source vtkInt.tcl 









available on the full range of Jav 







"Straight talk. straight from the best!” 
a November 2-7, 199 
| _ Keystone Resor 


CIRCLE NO. 366 ON READER SERVICE CARD 


116 


# Read in CAD part 
# 
vtkSTLReader sr 

sr SetFileName “../../data/424Q0-IDGH.st1” 
vtkDecimate deci 

deci SetInput [sr GetOutput] 

deci SetTargetReduction 9.9 

deci SetErrorIncrement 9.002 

deci SetMaximumIterations 8 

deci DebugOn 
vtkPolyMapper stlMapper 

stlMapper SetInput [deci GetOutput] 
vtkLODActor stlActor 

stlActor SetMapper stlMapper 


# Create graphics stuff 
vtkRenderMaster rm 


# Now create the RenderWindow, Renderer and both Actors 

set renWin [rm MakeRenderWindow] 

set renl [SrenWin MakeRenderer] 

set iren [SrenWin MakeRenderWindowInteractor] 

# Add the actors to the renderer, set the background and size 
Sreni AddActors stlActor 

Sren1 SetBackground 0.1 0.2 9.4 

SrenWin SetSize 45@ 450 


vtkCamera cam 
cam SetClippingRange 2.21973 110.986 
cam SetFocalPoint 128.766 86.0079 224.742 
cam SetPosition 133.866 68.8423 211.626 
cam SetViewAngle 30 
cam SetViewPlaneNormal 0.2298 -@.773329 -@.59G893 
cam SetViewUp -@.0185622 0.603548 -@.797111 
Sreni SetActiveCamera cam 


# render the image 
Siren SetUserMethod {wm deiconify .vtkInteract} 
Siren Initialize 


# prevent the tk window from showing up then start the event loop 
wm withdraw . 


Listing Two 


eatch {load vtktcl} 


# this is a tcl version to decimate fran’s face 
# get the interactor gui 
source vtkInt.tcl 


# create visualization pipeline 
# create decimated model with surface normals 
vtkCyberReader cyber 

cyber SetFileName “../../data/fran_cut” 
vtkDecimate deci 

deci SetInput [cyber GetOutput] 

deci SetTargetReduction 9.95 


deci SetErrorIncrement 0.002 
deci SetMaximumIterations 8 
deci DebugOn 
vtkPolyNormals normals 
normals SetInput [deci GetOutput] 


# ingest image and apply as texture map 
vtkPNMReader pnm 
pnm SetFileName fran_cut.ppm 
vtkTexture aTexture 
aTexture SetInput [pnm GetOutput] 
aTexture InterpolateOn 


# map to graphics system 
vtkPolyMapper cyberMapper 
cyberMapper SetInput [normals GetOutput] 
vtkActor cyberActor 
cyberActor SetMapper cyberMapper 
cyberActor SetTexture aTexture 


# Create graphics objects 
vtkRenderMaster rm 


# Create the RenderWindow, Renderer and both Actors 
set renWin [rm MakeRenderWindow] 

set renl [SrenWin MakeRenderer] 

set iren [SrenWin MakeRenderWindowInteractor] 


# Add the actors to the renderer, set the background and size 
Sren1 AddActors cyberActor 

Sreni SetBackground 1 1 1 

SrenWin SetSize 45@ 450 

# Define method to invoke when “u” is pressed in graphics window 
Siren SetUserMethod {wm deiconify .vtkInteract} 


# Define nice view 
vtkCamera caml 
cami SetClippingRange 9.0475572 2.37786 
caml SetFocalPoint @.052665 -@.129454 -@.@573973 
cami SetPosition @.327637 -@.116299 -@.256418 
cami CalcViewPlaneNormal 
caml SetViewUp -9.0225386 @.999137 @.0349@1 
Sreni SetActiveCamera caml 


Siren Initialize 


# prevent the tk window from showing up then start the event loop 
wm withdraw . 
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Tools, Languages, and 
Interacting with Machines 


Gregory V. Wilson 


ost authors write because they 
hope to strike it rich, or because 
it’s part of their job, or because 
they have something they’re itch- 
ing to tell you about. Jonathan Rosenberg’s 
How Debuggers Work falls into the third 
of these categories. After helping to de- 
velop the tools that made MasPar’s MP 
machines easier to program than most par- 
allel supercomputers, Rosenberg moved 
to Borland, where he worked on debug- 
ging tools. Having read the blurb on the 
back of this book, I hoped it would be 
for debuggers what Tanenbaum’s Oper- 
ating Systems: Design and Implementation 
was for its subject: a practitioner's guide 
to what matters when you actually have 
to get something built. 

Unfortunately, How Debuggers Work 
falls short. Rosenberg covers all the right 
topics — hardware and OS support, break- 
points, context and data inspection, multi- 
threading, GUIs, and how to handle op- 
timized code— but each time I thought 
he was about to get into the nuts and 
bolts, the section or chapter ended. 

For example, after pointing out that the 
PowerPC can normally execute instruc- 
tions out of order, but always executes 
them in order when debugging, he says, 
“This is something for debugger develop- 
ers and users of the PowerPC to watch 
closely.” I’m grateful for the warning, but 
I would have been more grateful if he’d 
told me what I could do about it. Simi- 
larly, after pointing out that it can be dif- 
ficult to set breakpoints on single-line for 
loops and outlining a simple-minded so- 
lution, Rosenberg says, “This solution is 
not foolproof...,” and then he stops. 

How Debuggers Work could also have 
benefited from more careful editing. The 
list of Java debugging classes, for instance, 





Greg is the author of Practical Parallel Pro- 
gramming (MIT Press, 1995), and coedi- 
tor with Paul Lu of Parallel Programming 
Using C++ (MIT Press, 1996). Greg can be 
reached at gvwilson@interlog.com. 
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contains the meaningless “public class ex- 
tends RemoteValue” seven times, a mis- 
take that is repeated in the tables later. 
Someone should also tell the author that 
the Heisenberg principle doesn’t actually 
say that “[a] debugger must intrude on the 
debuggee in a minimal way.” 

Having been so critical, I should now say 
that I think this book has a lot of potential. 
None of the undergraduate computer- 
science programs I’m familiar with teach 
students how to build tools for debugging, 
profiling, dependency management, or ver- 
sion control. As a result, most undergradu- 
ates enter the workforce either not know- 
ing how to use such tools, or believing that 
they aren’t really important. (After all, if they 
were as important as parsers, we’d have 
done four homework assignments on them 








as well, wouldn’t we?) If Rosenberg were 
to turn this book into a practical guide of 
the sort that exists for operating systems 
and compiler construction, he would do 
computing a great service. 


Programming Language Choice 

The second:book on my list, Programming 
Language Choice, was an even greater dis- 
appointment. Sooner or later, everyone in 
computing gets embroiled in a debate over 
the relative merits of different languages. 
A few years ago, after sitting through yet 
another presentation in which yet another 
parallel programming language was called 
“intuitive, powerful, and flexible,” I decid- 
ed to look through the literature for ex- 
perimental comparisons of the usability of 
different programming languages. 

I was surprised to discover that few 
have ever done such experiments. Think 
about that for a second: Almost everyone 
believes that some languages (Smalltalk, 
C++, Perl, Scheme) are “better” than oth- 
ers (Fortran and Cobol being the usual tar- 
gets for scorn), but I was only able to find 
one group that had ever tried to quantify 
the differences (“An Experiment to Mea- 
sure the Usability of Parallel Programming 
Systems,” by Duane Szafron and Jonathan 
Schaeffer in Concurrency: Practice and 
Experience, 8(2), 1996). So much for the 
“science” in computer science. 

When I mentioned this to colleagues, 
they were less surprised than I had been. 
“There’s so much variability among pro- 
grammers that no study could be mean- 
ingful,” was a common reaction, while an- 
other was, “The needs of different domains 
are so different...” However, pharmacolo- 
gists manage to study the effectiveness of 
drugs, despite variations in sensitivity of 
up to 10 million to 1, and they don’t seem 
bothered by having to specify an applica- 
tion area before starting a study. Even in 
computer science, we measure the usability 
of GUIs. Surely, I thought, something sim- 
ilar could be done for the one tool that 
every programmer uses? 
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(continued from page 117) 

When I came across this book, I hoped 
that it might be a step toward that goal. 
No such luck. With a few exceptions, this 
book might as well be titled Programming 
Language Advocacy. Most contributors 
simply describe their favorite language, 
then claim that it is well suited to under- 
graduate teaching, without offering any 
evidence stronger than their personal pref- 
erences. At its worst, this advocacy de- 
generates into hype. Do you believe, for 
example, that “Almost all Smalltalk pro- 
jects succeed,” or, “While other languages 
were being deliberately shaped to en- 
courage particular design approaches, 
Lisp...could mold itself around any ap- 
proaches that seemed appropriate”? 

Matters aren’t helped by the fact that 
the conference that gave rise to this book 
was held in September 1993. As a result, 
there is no mention of Java, whose ubiq- 
uity, safety, and object orientation make 
it a very strong candidate for undergrad- 
uate education, while Ada 95 is spoken 
of in the future tense, and defunct research 
languages like CooL and Omega are giv- 
en as much space as Smalltalk and C++. 

Programming Language Choice does 
have two redeeming features. The first is 
Marian Petre’s discussion of programming 
paradigms and cultures, which is worth 


reading carefully. She points out that most 
programmers unconsciously shift the 
paradigms of the language they happen to 
be working in. Similarly, in the absence of 
a Clearly defined model of what the com- 
puter is doing, both expert and novice pro- 
grammers will borrow from whatever mod- 
els they have and construct a “just-so” story 


Sooner or later, 
everyone gets 
embroiled in a 

debate over the 

relative merits of 
different languages 





to explain the behavior they observe. I also 
enjoyed the chapter by Lee and Stroud on 
C++, primarily because it laid out, in de- 
tail, the criteria to use in choosing a teach- 


ing language. These discussions make the 
book worth borrowing, but you'll proba- 
bly want to spend your money elsewhere. 


The Media Equation 

The same is true of 7he Media Equation, 
even though it is a much better book. 
Reeves and Nass both work at Stanford 
University, where they study how people 
react to and interact with computers, tele- 
vision, and other media. They have dis- 
covered that even when people know 
they’re dealing with a machine, they treat 
it as if it were a social being— a person. 
Similarly, people who've been flattered by 
a computer program will think that they’ve 
done better work with it, even if they 
know that it’s just a program and that its 
flattery is preprogrammed. 

This may sound a bit trite, but the au- 
thors’ initial detailed description of their ex- 
periments and results is fascinating. How- 
ever, I was less fascinated by their third and 
fourth detailed descriptions, and by Chap- 
ter 6, I was really hoping to see a sentence 
starting, “We can summarize our other work 
as follows...” Topics discussed in the book’s 
later chapters aren't any less interesting, but 
after 200 pages, I’m more interested in con- 
clusions than experimental design. 
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Newfire has unveiled Catalyst, an author- 
ing tool for creating 3-D games for the 
World Wide Web. Catalyst is designed as 
an extensible base platform that can be 
extended through plug-ins. The Catalyst 
base platform supports/provides scene 
composition, an interactivity editor, real- 
time playback and analysis, performance 
optimizer, and project manager. A Cata- 
lyst SDK will available shortly. The Cata- 
lyst base product is priced at $1995.00 for 
a single-user license. Newfire’s plug-in 
modules are priced between $250.00 and 
$1000.00 each. 

Newfire Inc. 

12901 Saratoga Ave., Suite 4 

Saratoga, CA 95070 

408-996-3100 

http://www.newfire.com/ 


Pro\Sim has announced Version 2 of its 
PinQuik (PQ) Toolkit for system admin- 
istrators and developers. PQ is a user- 
interface development package, which can 
simultaneously execute in graphical and 
text modes. PQ is delivered with sample 
panels, bar menus, and forms that can be 
used as examples for users to start devel- 
oping their own applications. PQ has sev- 
eral UNIX System Administration Utilities 
built in, including disk utilities, adminis- 
tration tools, and others. PQ is imple- 
mented in Tcl/Tk, and a copy of Tcl/Tk 
is distributed with PQ. 

Pro\Sim Corp. 

14201 Memorial Dr., Suite 400 

Houston, TX 77079 

800-489-3592 

http://www.prosim.com/ 


Headspace’s Beatnik is a web-based soft- 
ware system for the creation and playback 
of interactive music. The Beatnik system 
consists of the Beatnik Editor and the Beat- 
nik Plug-in. The Beatnik Editor, available 
for the Macintosh, can import music and 
sound in a variety of industry-standard 
file formats, and outputs Real Music For- 
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mat (RMF), which allows for MIDI music 
to be integrated with digital audio sam- 
ples. The Beatnik Plug-in manages play- 
back on web browsers. Beatnik supports 
a set of Java-callable functions that allow 
a web site to play music based on user 
events, such as a mouse-click or a mouse- 
over. These events can also trigger indi- 
vidual notes, sampled voices, or sound 
effects; start or stop music; and change 
tempo, volume, pitch, or mix. The Beat- 
nik Plug-In and the Beatnik Editor are both 
freely available. 

Headspace Inc. 

217 South B St. 

San Mateo, CA 94401 

415-696-9400 
http://www.headspace.com/beatnik/ 


TracePoint Technology announced 
HiProf, a hierarchical profiler available 
for the Windows Intel platform. HiProf’s 
hierarchical profiling enables develop- 
ers to conduct code analysis on the bi- 
naries of 32-bit C/C++ Windows appli- 
cations. Hierarchical profiling shows 
each function’s self-time and the num- 
ber of calls taking place between all par- 
ent and child functions, and the time that 
the activity takes. This information is dis- 
played in graphical pie charts, his- 
tograms, and lists. HiProf instruments 
and profiles compiled and linked EXEs 
or DLLs, using its patented Binary Code 
Instrumentation (BCI) technology. No 
source code or OBJ files are required 
with HiProf. HiProf also enables devel- 
opers to selectively exclude DLLs or por- 
tions of their EXE file from profiling in 
order to drill down on specific portions 
of an application, or to evaluate third- 
party components. HiProf reports on 
multiple threads individually, and sup- 
ports all applications compiled with Vi- 
sual C++ 2.x and later. HiProf’s sug- 
gested retail price is $599.00. 
TracePoint Technology Inc. 

One Almaden Blvd., Suite 1100 

San Jose, CA 95113 

408-283-5350 
http://www.tracepoint.com/ 


DFL Software has announced 32-bit Ac- 
tiveX versions of its Light Lib Magic Menus 
component. This control allows develop- 
ers to create menus with background im- 
ages, bitmap menu items, and tool button 
palettes. The professional version of Light 
Lib Magic Menus is $139.00, while the stan- 
dard version is $99.00. 

DFL Software 

55 Eglinton Ave., East, Suite 208 
Toronto, ON 

Canada M4P 1G8 

416-487-2660 

http://www.dfl.com/ 


ObjectSpace’s Voyager is a platform for 
agent-enhanced distributed computing 
in Java. It supports both traditional and 
agent-enhanced distributed programming 
techniques to create sophisticated net- 
work applications for equipment rang- 
ing from desktop computers to embed- 
ded consumer devices. Voyager enables 
you to create agents that can roam a net- 
work and continue to execute as they 
move. Moving agents and other objects 
can exchange remote messages using 
regular Java message syntax. Objects can 
be constructed remotely using the regu- 
lar Java construction syntax, static meth- 
ods can be executed remotely, remote 
exceptions are automatically rethrown 
to the caller, and serializable objects can 
be passed and returned by value. Once 
serializable objects are created, you can 
move any of these objects to a new lo- 
cation, even while the object is receiv- 
ing messages. Messages sent to the old 
location are automatically forwarded to 
the new location. The entire Voyager sys- 
tem, is 70 KB in a compressed jar file, 
and 150 KB uncompressed. Voyager is 
available free for commercial use at the 
ObjectSpace web site. 

ObjectSpace Inc. 

14881 Quorum Dr., Suite 400 

Dallas, TX 75240 

972-934-2496 
http://www.objectspace.com/ 


WebRunner Toolkit from Taligent is a web- 
development toolkit consisting of Client 
Works, Server Works, and Bean Factory. 
WebRunner Client Works is a set of Java 
class libraries that form a framework for 
JavaBeans and Java applications. Web- 
Runner Server Works is a class library that 
abstracts common server-side API’s (such 
as CGI and NSAPI) so that you can de- 
velop API-independent server-side web 
applications. C++ and Java versions are 
available. Bean Factory is a tool for cre- 
ating, modifying, and testing JavaBean 
components. 

Taligent Inc. 

10355 N. De Anza Blvd. 

Cupertino, CA 95014 

408-255-2525 

http://www.taligent.com/ 


SoftQuad International has introduced the 
SoftQuad AdaptAbility Toolkit, a suite of 
technologies designed to make the World 
Wide Web accessible to people with dis- 
abilities. SoftQuad AdaptAble Technolo- 
gies consists of four components: a Visu- 
al Dynamic Keyboard, a Screen Enhancer, 
an integrated screen reader, and cus- 
tomizable user profiles. The Visual Dy- 
namic Keyboard is an on-screen keyboard 
that lets users enter text, select commands, 
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(continued from page 120) 

activate dialog box controls, and so on, 
without using a traditional keyboard and 
mouse. The Screen Enhancer is a screen- 
magnification technology that rerenders 
the desktop and/or the application in log- 
ical ways for better, more intuitive navi- 
gation and viewing. SoftQuad’s integrat- 
ed screen reader is both application 
aware and HTML aware. In addition to 
standard screen-reader elements, users 
are able to set up automatic routines for 
reviewing an HTML page when it ap- 
pears. SoftQuad’s AdaptAble Technolo- 
gies also include customizable user pro- 
files, in which users can select display 
and control preferences. User profiles can 
be selected upon startup, so multiple in- 
dividuals with varying preferences can 
use a single terminal. 

SoftQuad Inc. 

20 Eglinton Ave. West, 12th Floor 
Toronto, ON 

Canada M4R 1K8 

416 544-9000 

http://www.softquad.com/ 


Arial Software’s Virtual Print Engine gives 
developers using Visual Basic, C/C++, 
FoxPro, Delphi, and other languages the 
ability to dynamically create and output 
documents by invoking any of Virtual 
Print Engine’s 65 page-building function 
calls. Objects such as lines, polygons, 
bitmaps, text, and barcodes can be po- 
sitioned, rotated, and scaled, and can 
incorporate external data at run time. 
Developers can give users print pre- 
viewing. The Virtual Print Engine has no 
run-time fees or royalties, and a list price 
of $398.00. 

Arial Software 

1225 NW Murray, Suite 101 

Portland, OR 97229 

503-646-4515 
http://www.arialsoftware.com/ 


Snowbound Software’s RasterNote An- 
notation Toolkit for Windows 3/95/NT 
lets you use circles, lines, and freehand 
shapes to annotate documents. Raster- 
Note toolkit is available as a DLL for Win- 
dows 3.x, and OCX/ActiveX for Windows 
95/NT, and costs $995.00. 

Snowbound also announced version 
6.0 of its RasterMaster UNIX image li- 
braries. New features include enhanced 
document imaging support for hot doc- 
ument archival, deskewing, despeckling, 
automatic aspect ratio correction, and 
GIF and PNG support. The RasterMaster 
toolkit for UNIX costs $2495.00. 
Snowbound Software Corp. 

P.O. Box 520 
Newton, MA 02159 
617-630-9495 


http://www.snowbnd.com/ 
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RoseGUI from HexaTech is an ActiveX 
component for developing GUIs. Fea- 
tures include creating interactive scenes 
containing any objects, shapes, and be- 
haviors of objects controlled by user 
bitmaps, simulating real-life objects such 
as airplanes and TVs, support for flying- 
mouse highlight, and scripting support. 
RoseGUI allows you to supply your own 
bitmaps to control the look and feel of 
your application. 

HexaTech 

725 Mariposa Ave., #107 

Mountain View, CA 94041 

415-254-0610 

http://www.hexatech.com/ 


Interactive Network Technologies, has an- 
nounced Version 1.1 of Carnac, a 2-D 
graphics toolkit. Two SDKs have been 
added to the toolkit: the Flavors SDK and 
Dynamic Scenes SDK. The Flavors SDK 
aids production of User Defined Primi- 
tives (complex shapes), While the Dynamic 
Scenes SDK assists production of code 
that generates dynamic scenes on the fly. 
Additionally, support for 1, 8, and 24-bit 
rotatable, sharable, and scalable images 
with full transparency control and a CGM 
output option have been added. Carnac 
is available for Windows 95/NT and most 
common UNIX implementations. 
Interactive Network Technologies Inc. 
2901 Wilcrest, Suite 300 

Houston, TX 77042-6011 

713-975-7434 


http://www.int.com/ 


Preview Software announced TimeLOCK 
3.0 Transaction Server and Client Builder, 
a client/server extension to Preview’s 
trialware development kit. TimeLOCK 
Client Builder allows you to wrap your 
software with “try before you buy” and 
electronic commerce capabilities. The 
Client Builder supports multitier distri- 
bution as well as direct sales, and allows 
connections via the Internet, modems, 
voice, and fax. With the TimeLOCK 
Transaction Server, software companies 
can handle all aspects of online trans- 
actions royalty free. The Transaction 
Server is available for both Windows NT 
and Solaris, and a single-key license 
costs $4995.00. A license for TimeLOCK 
Client Builder and one key module costs 
$795.00. 

Preview Software 

345 California Ave., Suite 3 

Palo Alto, CA 94306 

415-326-2242 
http://www.previewsoft.com/ 


Edgeworx, from the Antares Alliance 
Group, is an object-oriented web devel- 
opment and execution framework using 
Microsoft’s Visual Basic for Applications 





(VBA). EdgeworX uses a class library of 
ActiveX objects to represent the base com- 
ponents of a web application, including 
objects for database access. EdgeworX 
works on any Windows 95/NT web serv- 
er that supports CGI, ISAPI, or NSAPI, and 
costs $399.00. 

Antares Alliance Group 

17304 Preston Rd., Suite 1200 

Dallas, TX 75252 

972-447-5500 

http://www.aag.com/ 


emWare has announced EMIT (Embed- 
ded Micro Interface Technology), a micro 
web server designed for embedded de- 
vices. EMIT requires 750 bytes of ROM 
and 30 bytes of RAM. It achieves its size 
by distributing part of the server func- 
tionality to the client, emManager. The 
client interface consists of emObjects, pre- 
programmed functions in the form of Java 
applets, ActiveX components, and others. 
A single-user EMIT SDK with ten em- 
bedded licenses costs $1200.00. 

emWare 

1225 E. Fort Union Blvd., Suite 220 
Midvale, UT 84047 

801-256-3883 

http://www.emware.com/ 


NetManage has announced Chameleon 
UNIXLink 97, which uses the X Consor- 
tium’s Broadway standard to run X ap- 
plications from within a web browser. 
Chameleon UNIXLink 97 uses LBX to han- 
dle data over low-bandwidth lines, and 
includes a web-based management tool. 
Chameleon UNIXLink97 sells for $400.00. 
NetManage Inc. 

10725 North De Anza Blvd. 

Cupertino, CA 95014 

408-973-7171 
http://www.netmanage.com/ 


Rational Software has announced new ver- 
sions of SQA Suite 6.0 and RequisitePro 
2.5, both of which have been integrated 
with the Rational Rose visual modeling 
tools. SQA Suite 6.0, a suite of automat- 
ed client/server testing tools includes new 
capabilities for HTTP-based performance 
testing and a new Object Scripting capa- 
bility. RequisitePro 2.5, a requirements 
management tool, adds integration with 
Microsoft Visual SourceSafe, in addition 
to Rational Rose. SQA Suite 6.0 starts at 
$9995.00, while RequisitePro starts at 
$1295.00. 

Rational Software Corp. 

2800 San Tomas Expwy. 

Santa Clara, CA 95051 

408-496-3600 

http://www.rational.com/ 
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Secure against systematic “crackers”! 


WIBU®-BOX for LPT, COM and ADB, USB, trans- 
parent and cascadable, as PCCard and (E)ISA card. 


1 BIOxe Windows”, Windows 95, Windows NT, 
MacOS", OS/2®, Novell. 


Protection without source code modification 
CD-ROM Protection. 


API independent of programming language and 
operating system 








WIBU-SYSTEMS AG 
mY . Rueppurrer Strasse 54 : 3 aba tN 
—_ D-76137 Karlsruhe, Germany 1617 St.Andrews Dr, Lawrence, KS 66047 
SYSTE WS Tel. +49-72 1-93 172-0 - FAX 93172-22 Tel.(913) 832-2070 - FAX (913) 832-8787 
CIS 100142,1674 - email: info@wibu.de CIS 71141,3624 - email: sales@griftech.com 
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Dr DeeBee® ODBC Driver Kit 
The Easiest Way to Create an ODBC Driver 
Build an ODBC driver for your database to connect it to 
desktop favorites like Access, Visual Basic and Powerbuilder 
¢ Full Source Code Included |. : 
eee ee athe fe “The only project-oriented enterprise bug 


¢ No ODBC Knowledge Reauired : . - 
© 2 to 4 Weeks Develinmnent Time tracking system for Microsoft.. Developers 


Also available, Dr. DeeBee ODBC Tools © ¢ Integrates with Microsoft tools & applications 


Debug and optimize ODBC applications and drivers fast! © Enterprise ready & scalable . 
Need More Info? Visit: www.syware.com = 3 tler architecture, ODBC, & 32-bit 


Or call: 617 497-1300  _ 4-800-364-5467 Elsinore 


oe TECHNOLOGIES, INC.1™ 
— SYVUVAAE — PO. Box 91 Kendall, Cambridge, MA 02142 Raleigh Group International @ www.ralgi.com [RIMWEECCumn 
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Your solution will be 2 ¢ 2 oe ee 















ODBC SDK is the ready for distribution 
quickest and in 
most economical 

solution for 


your needs! 












































™ 











Editor component 




















Add a colorful syntax-highlighting 
editor to your applications. Easily 
customized for any syntax. 


Includes source and examples for 
C, BASIC and HTML. 

































































be happy to discuss your needs. 


Automation Technology, Inc. 
2890 Zanker Road, Suite 200 
San Jose, CA 95134 

















































































































































































































Ultimate TCP/IP “ 


r Internet/Intranet Client and Server Development Kit 
_ © Navala ariatic _ . High Performance C++ Class Libraries 


oN , : a ¥FTP ¥ Clients and Servers 
os 7 | OPE SVUILC TUT VCVCIUVEl | | ¥ DNS ¥* Custom Protocols 
_ “NNTP * NT Services 


Professional (w / full source code) $499.00 
Includes One year of technical support. 


: : ay : é zi & 
| and Adobe Pre h a wide range of available develope: Dundas Software 
s ee A eee eee ees ae ae * 30 day money-back satisfaction guarantee. 
2 +O fF Vi Fee 4 - : 1G : ¢ Visa, MasterCard, American Express, 
ihe ead eee page clo J pec 


ca : : : check, money order. 
: ¥e 41 5-96/- See ce : =f Sales: 416 239 7472 * We will deliver via Internet, Compuserve, 
Fax: 416 239 2183 asda 
EMail: sales@dundas.com 


WWW: www.dundas.com 
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The best high performance 
portable compression 
libraries for DOS, 16-bit 
and 32-bit Windows, 

OS/2, Unix, Macintosh, | 7” 

embedded systems, and 7 

practically anything else, | 
period. 


Call 1-800-775-1073 


Never shell out to the OS again! Crusher's DC Micro 
robust 45-function API compresses buffers, gg Development 
files, creates multi-file archives, stores PO. Box 54588 
subdirectories, creates self-extracting Lexington, Kentucky 40555 USA 


Tel (606) 245-4175 
executables, encrypts, and more! Fo (608) 245-9305 





News Server Technology - FREE Trial 
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Print bar codes within your applications 
with our TrueType fonts. Code 39, Code 
128, UPC, etc. Free sample code available. 


———_ 





Azalea Software, Inc. 
1800 48-ASOFT www.azalea.com 


Beginning MFC OLE/Active X 
Programming from Wrox Press 


“Learn how COM works in practice 
*Create real world OLE servers & clients 
* Step by step projects with full explaina- 
tions * Uses MFC & Wizard support for 

fast results 


ISBN: 1-861000-87-7 


Tox programming titles, please 509 pages $39.95 
Author. Julian Templeman 


ple chapters anda full content table. 4 WWW.Wrox.com 
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PO Box 13408 
Las Vegas, NV 89112 


More fun than being in Las Vegas! 
See the game at http://www.3d-casino.com. 


Fastgraph programmers write games that ship! DOS, Windows or Windows 
95, the games you play were written with Fastgraph. 


Fastgraph for DOS: $249 
Ted Gruber Software 


Visit our web page at http://www.fastgraph.com 


Announcing another great game 
written with 


Fastgraph® 
Programmer’s Graphics Library 
3D Casino Las Vegas 


All the excitement of a live 
action casino under Windows 95. 


Fastgraph for Windows: $249 


Voice (702) 735-1980 
FAX (702) 735-4603 
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WMITLIB C++ Multithread Library 


Make multithread and multiprocess development simpler with the WMTLIB C++ 
classes, and gain cross-platform portability at the same time. 










WMTLIB includes classes to manage synchronisation and data transfer between 
threads, both intraprocess and interproccess, with documented source, royalty 
free deployment, and inexpensive licensing per developer. 


Supports Win 32 (NT and Win95), 0S/2, LinuxThreads, Solaris 2.5 (Solaris 
threads and POSIX 1003.1c), UnixWare 2.1, more to follow. 


See www.westgold.com for more details. 


Westongold Ltd. 
email: info@westongold.com or call (+44) 1992 633801 
















16 & 32 bit Serial Comm Libraries 
Personal Communications Library Supports 20 ports 
to 115200 baud, 16 & 32 bit DPMI, multiport dumb cards 
(Digiboard, BOCA), any IRQ & UART address, interrupt driven, 
HW flow control, 16550 UART & modem AT commands. 
Source code included. Specify C/C++ (Win or DOS), Turbo 


Pascal (DOS), Visual Basic (Win or DOS), or PowerBASIC 
(DOS). 


$75 + s&h includes manuals & pap bee! support. Get FREE 
shareware version form our BBS or ftp.marshallsoft.com. 
Visit our home page at www.marshallsoft.com. 


MarshalliSoft Computing, Inc. 
P.O. Box 4543, Huntsville, AL 35815 
email: info@ marshallsoft.com 
881-4630 Voice, 880-0925 FAX, 880-9748 BBS 
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AMERICAN 
HEURISTICS 
CORPORATION 


Consulting support and training 
in business intelligence 


www.heuristics.com @ info@heuristics.com 


304-547-4201 


Jity metric, provides visual tools for software testing and 


‘generated from C-++ code. The tools generate metrics for 














The McCabe Visual ToolSet™ 
McCabe & Associates, inventor of the cyclomatic complex- 


code coverage. Unit and integration test conditions are 


polymorphism, encapsulation and inheritance. Overloaded 
modules are displayed on the graphical structure charts. 


Uncover Your Software =: == 
— ren McCabe 
Gas Way a Associates® 
For Further information Call 800-638-6316 or Fax 410-995-1528 
http://www.mccabe.com 


PARSING JUST GOT EASIER 


| Parsing input used to mean tricky logic with lots | 


of places for bugs to hide, slipped schedules, 


| difficult maintenance. Nobody’s idea of fun. 


Now, more powerful, more convenient, | 


AnaGram V1.5 changes all that. You can take — 


charge and concentrate on the real problems. | 
Expressions? Database queries? Scripts? | 
Command languages? No problem. Call for free | 
trial copy. 


Anagran™ by Parsifal Software 
P.O. Box 219, Wayland, MA 01778 


CIS: 72603,1763 info@parsifalsoft.com | 
(800) 879- 2577 


: Btrieve Database Access Fast & Easy! 


Get blinding performance and native access to Btrieve 
databases without writing code! Our advanced data 
binding technology outperforms the VB data control, 
ODBC, Jet and other access methods. Smithware’s 
ActiveX Controls give you total control over your data 
with seamless integration of Btrieve’s client/server 
Controls for Btrieve extended operations, extended joined record sets, 
bound controls and more. Use our controls in your favorite development includ- 


Smithwere 





= ing VB, Delphi, VC++, Internet Explorer or in any environment that supports 


ActiveX. You can even enable your application over the web. Check out our 
benchmarks and Internet demo at Www.smithware.com/activex or call us 
today and see for yourself how you can get fast easy access to your Btrieve Data! 


e@ 
Smithware, Inc. 
2416 Hillsboro Road, Suite 201, Nashville, TN 37212 
Phone: 615-386-3100 or 800-837-6316 
E-mail: info@smithware.com 
http://www.smithware.com 
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lable. Call us and we'll mail you a 
free demo & booklet ASAP. Call now! 


iggeterse FREE demo!’ 
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* ProMathiVB - numerics 
* FinLib/VB - financial * ProBas - & other 15 DOS libs 
 VoxLib/Pro -tslephony * VB training - 2 day intro class 


‘SpeilCheck/VB - spelling * Custom -C, ASM, VB programming 
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Programming Tools 
For Programmers 
VB * DELPHI ° CLIPPER 





|WEB COMMUNICATIONS MADE EASY!) 


App-Link Internet Messaging System 


The new App-Link Internet Messaging System B= 
(iMS) makes it EASY to communicate between [= 
applications locally, or over any TCP/IP network. fie 
With iMS, all you have to do is say “here's my Fe 


= =©—_ ADDRESS FOR SUCCESS _ 
Bh [_http://vwwcaics.eduy 



























e Earn B.S. and M.S. in Computer Science 































INTERNET ¢« VdBASE « VO © DISTANCE EDUCATION aE eiipcbspunlnu skeet 
ay . . ive event fires on the other end when the B= 

e Product Info * ° Object oriented B.S. program AMERICAN message is delivered. passing the data and its B= 
¢ New courses in Java Networking HTML. MIS INSTITUTE : origin as parameters. Communicate between any fas 

@ Demos ‘ aa ? a ee =4 containers that support a VBX or OCX. All versions of Windows are supported, and other fe 
° Approved by more than 275 companies wa iavats [1 features such as queuing, message packing and formatting, auto program load, etc are 

e M H a peT TENCE |) also included. Forget TCP/IP protocols, DCOM, etc. App-Link iMS is fast. reliable and fee 

Online Ordering 7 Follows ACM/IEEE guidelines SCIENCES above all else, extremely easy to use. App-Link iMS handles the dirty networking tasks E 










¢ Thousands of students throughout U.S. ACCREDITED 
MEMBER 


@ So you Can relax and focus on your application. Please visit our web site for details. 


Free catalogue 1-800-767-AICS —***.,., http://www.synergysw.com 


of Universities Synergy Software TechnologiesInc. — sales: 800-294-8514, tel: 802-878-8514 = 


or http://www.aics.edu. and Colleges 159 Pearl Street fax: 802-878-4055 B= 


; 4 Essex Junction, Vermont 05452 sst@synergysw.com Be 


e Online Delivery 
Get Connected! 


www.zaccatalog.com 















Zip and Unzip from your apps with the 


XCEED ZIP(zIP 


COMPRESSION LIBRARY | | 


your Windows applications! © 


a ™ : 
DynaZIiP 3.0 aga en 


The new ROYALTY-FREE DynaZIP family of developer's tools let & 
you add ZIP and UNZIP capabilities to your Windows §- 
applications. No more "shelling" to DOS, no more fussing with & 
proprietary compression formats. DLLs, VBXs, OCXs and a 
new database interface provide full access from many & 
languages. Fast, reliable, and easy to use! 16 and 32 bit & 
versions, supports long filenames. 


Fully supported, 30-day no-risk guarantee! 
Call today, toll free: (800) 962-294 























Easy to use VBX, OCX and VCLs 
Fast, compact and reliable 

100% PKZip 2.04g compatible 

All 16 & 32-bit controls for $199.95 
Over 40 Zip and Unzip functions! 














When you need to provide industrial 






strength encryption within your software 









projects, simply wire in carrick. 
1 800 ENCRYPT 
www.encryption.com 


Get the fully functional free trial version! 
www. xceedsoft.com/dobbs 











sSaripusti a esaeerees seigise eons Sass ice : 
The Complete FORTRAN Programmer’s Toolkit. 
1 Create sophisticated state-of-the-art user interfaces for your FORTRAN 
| programs. Spindrift’s callable subroutines and functions let you 
Have data entry screens, dialog boxes, scrolling list boxes 
pull-down menus, push buttons, help ponels, etc. All with full 
mouse support. 
¢ Much more! 281 subroutines and functions for keyboard, 
screen, mouse, DOS control, and hardware status. 
| Comprehensive demonstration program shows what you can do and how to do it. 
Now shipping Version 3.0 with all new User Guide. 


PRICE: 16 Bit Compilers - $149 32 Bit Compilers - $289 


ma Spindrift Laboratories, Ltd. 
-78 Tanglewood Path e Galena » IL 61036 ¢ USAF 

|Phone: (815) 777-8240 ¢ FAX: (815) 777-82411 
E-mail: dgable@galenalink.com 


@ Complete multidimensional array language 
@ Complete package of mathematicc 
@ Full error handling package 


: Advanced Support Modules : 


Signal Processing (VEW) Finite Element 
Financial Utility(NEW) Least Squares 


Call for complete list 
FREE demo program on website 
http://www. wolfenet.com/~dyad dyad@wolfenet.com | 
Dyad Software Corporation 
6947 Coal Ck Pkwy SE #361 Newcastle WA 98059 
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* Generates useful docs for C/C++ code 

* Uses existing comments with no changes 

* Metrics 

* HTML and RTF 

* Windows 95 and Windows NT 

¢ FREE evaluation version at www.bbeesoft.com 


ro] =] eon me Ol Uh gL | 4 


1-800-214-4746, °297 
info @ bbeesoft.com, P. O. Box 541, Hudson, MA 01749 
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+ WANTED + 


Major publisher with national 
distribution seeks SOHO, Personal 





Need a more flexible storage model than simple persistent C++ 
classes provide? Adaptive Object Storage provides a superior 
solution to managing data structures as they change over the 
life of an application. 


VICTOR 


Image Processing Library 






























































ane ; Fast BMP, TIFF, PCX, GIF, TGA, PNG, JPEG. Adjust 
© compressed a databases” brightness, contrast, sharpen, create filters, resize, rotate, productivity titles written in C+ or 
* ICCESS to most data a database is restored +more of single image, multiple images, or any image area: | 
¢ load-on-demand for large values color reduction to optimum, specific, or std. palette; print; | C++ for Win 3.1, NT. Workgroups 
° a a required scan; crop, combine, compare, blend images. 2 : : 
ava St P Ort 


Win 95 for immediate license 


Great for bandwidth-efficient and responsive client-server Web 
applications. For C++ applications on Win32 platforms. 


G | “ Get @ FREE EVALUATION «1: 
a apagos http://www.galapagos1.com 
Software, ne. For more info, call 800-562-2895 


DOS $199, 16-bit DLL $299, 32-bit DLL $499 
Catenary Systems or affiliate relationship. 


314-962-7833/fax: 314-962-8037 | 
www.catenary.com/victor Fax Ms. Zack 1-954-698-0057 
ask for free demo src avail visa/me/c.o.d. 











S See ees ee 
CrypKey Software Licensing Syste 
“Software protection with NO hardware lock and NO disk key ” 
CrypKey is software copy protection that is: 
* completely secure from any disk copy program 


* perfect for CD-ROM or INTERNET distribution! 
* cost effective, user friendly, and 100% guaranteed to satisfy! 


Diagnose, advise, configure, evaluate, CrypKey can increase your software sales: 

: . ‘ mt * upsell options and levels of your software _ 
and plan with the Amzi!® LogicServer ¢ lease or demo your software by runs or time ; 

. : 5 * enable or upgrade your customers instantly by phone, fax or email! 
tools and libraries (DLLs) for Win NT New! unique Ready-To-Try features upon install allows 1 trial period only per customer. 
95 ox, Linux & Solaris. For C/C++, New! unique Add-On feature-add more options, levels, runs or time to existing licenses. 
Ja va, VB, Delphi, Web servers and : New! SIup Bey ibaa ideied in ae 5 minutes with no source iad anes . 
more. Use ODBC data. FREEWARE ee ee ia oan en 
d d ti / Ww, b S , 7 CrypKey is produced by Kenonic Controls Ltd.—engineering and software since 1972. 

emos anda articies on our We Ite. Sicsiniile Ganivadi tiadibed 

7175 - 12th Street South East 


. Sues Email info@amzi.com Calgary, Alberta, Canada T2H 256 


4 2 7 7 403) 258- : 
40 Samuel Prescott Call +1-508-897-7332f yf teppei en ler pte 


Stow, MA 01775 USA Fax +1-508-897-2784 F : /www.kenonic.com/crypkey.html 
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Az-Tech Bytil weit 
Software NOW 


Internet: 
www.az-tech.com 
E-Mail: 
sales@az-tech.com 
Voice: 


(816) 776-2700 ME 
Fax: 
(816) 776-8398 Cony Protection 
meee  _ License Control Pa 212 504-3577 


Software : 
fi Int’l Office Tel: +9 


Security MAU CUTS CES UTM E2972 587-5796 Br has sales com 


Satie eee 


L ock Sm ; th The New Level in Security 
] - SONY Fingerprint Identification Units - 
Disk, CD or Internet installed software co ca = 


V Date & Time Locks V Feature Switching internal CPU + RS-232 
. : interface 
V Network License V Data Encryption Enables user identification 


V Remote Update ¥Y Serialization and authentication via 
: : fingerprints 
Secure your software disks with: Can store 1000 templates 


No royalties or limit on products Includes software i» Call or write for FREE brochure 
developer's kit for . . 
1-800-688-8116 Windows and DOS «> See our web site for detail 


www.LockSmithShop.com 1533 Spruce St. Riverside, CA 92507 
Sales @LockSmithShop.com 0 Software, Inc. (909) 222-7600 www.iosoftware.com 


http://www.softelvdm.con 


GAMELON by MENAI 
http://www.menai.com 


©@ srIsTOL TECHNOLOGY 
: http://www.bristol.com 
“With Wind/U, you can use the Microsoft Win32 API and MFC to 
develope and maintain a single source code for Widows, UNIX, 
OPEN VMS, and OS/390 versions of your applications.” 


Lock Out Hirates. - 
Lock In Profits! 4 


The Marx CRYPTO-BOX is the result of 
over 10 years experience in effective 
software protection. 
@ microprocessor controls ID codes, 
memory, dynamic algorithm and 
high speed data encryption 
@ remote access to passwords and counters 
@ license metering in networks: single key per LAN 
404-321-3020 FAX: 404-321-0760 


AR 1-800-MARX INT 


20 Executive Park West, Suite 2027, Atlanta, GA 30329 
INTERNATIONAL, Visit our Home Page: http://www.marx.com 


oe Se eee 


| l | DLL - OCX - VBX 

@ Barcode recognition from bitmap 

@ Barcode + text write into bitmap 

@ Skew correction © Noise + Crop 
@ Annotate image @ Line removal 
@ TIFF r/w - de/compress - fast scale 


Tel: (714) 964-6666 | | 
Axtel, Inc. Fax: (714) 964-6766 & 


‘mo on http://www.axtel.com 


ARERR RT 


and C++ DOCUMENTATION TOOLS (v. 7.0) 


¢ C-CALL ($69) Graphic-tree of caller/called function hierarchy, cross-reference, 
file/function index. 


© C-CMT ($69) Creates/inserts/updates comment-blocks (functions/identifiers 
used) for each function. 

e C-METRIC ($59) Calculates path complexity, counts lines with comments, code, 
'C' statements. 

¢ C-LIST ($69) Lists and action-diagrams, or reformats source into user-selected 
standard formats. 

© C-REF ($69) Creates cross-reference of local/global/define/parameter identifiers. 


e C-DOC ($199) PACKAGE All 5 programs integrated as DOS program. <10,000 
lines. C-BROWSE Windows graphic-tree viewer. 


¢ C-DOC Professional ($299) DOS, Windows, 0S/2, 1,000,000+ lines. 
¢ NEW VER 7.0! WEB HTML REPORTS! 


SOFTWARE BLACKSMITHS INC. email @ swbs.com 
6064 St Ives Way, Mississauga —Voice/Fax (905) 858-4466 
ONT Canada L5N-4M1 http://www.swbs.com 


p://www.wrs.com 


hitp://wwwrestancase.ch/da” 
Strong WEB Site for C or PL/M Developers 


INTEL 
http://www. intel.com/ial/vtune/index/html 


INTERACTIVE SOFTWARE ENGINEERING 
http://www.eiffel.com 


QUINTESSOFT ENGINEERING, INC. 
http://www.quintessoft.com 


Code navigator for C++ 


http://www.careermosaic.com/ 


cmisy' ante 


‘ NuMEGA 
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SWAINE’S FLAMES 


Perplexed 


y world consists of those items that I’ve filed away in their proper places, and all that other 
stuff. It has taken me altogether too long to figure out that nearly all the interesting stuff is 
in the second category, the unfiled mess. Properly filed things become less interesting 
through the very act of filing them. And the most interesting things are the things that I couldn’t 
file if I tried. 

I refer to the nonplace where I file these unfiled items as my futility closet, because of the 
futility of trying to find anything there. All my best search strategies are directed at finding filed 
things; I have almost no algorithms for sifting through the muddle in my futility closet. But there 
should be some algorithm I could use, other than blind stumbling search. There’s really a lot that 
I know about this uncategorized category. 

For one thing, everything there is there because I once thought it was interesting or useful. 
That narrows it a lot. And these things have a lot of connections to one another and even to items 
that are properly filed. They just don’t fit well into any of my tidy hierarchies. I think the answer 
has something to do with being precise about uncertainty, but I don’t know precisely what. I’m 
perplexed. 

That could be a clue right there. Ted Nelson once defined the word “perplex” (apparently 
coined by Frederick C. Crews in The Poo Perplex) as “a precisely delineated muddle.” Precision 
about uncertainty. Ted thinks that one of the many virtues of hypertext is that it allows “the true 
uncertainties of thought to be accurately recorded.” 

Actually, I thought that was the definition of this column. 

New subject. I mentioned here recently that I was setting up a Hall of Flame web site to which 
anyone can submit nominations for particularly dumb things that deserve recognition. 

My inspiration was an old magazine by Roger Price called Grump, with the subtitle “For people 
who are Fed Up with all the Dumb Things that are going on.” (I’m doing the capitalization from 
memory.) The site is up at http://www.cruzio.com/~mswaine/. It’s getting some good dumb- 
thing contributions, and I'll share some of the dumbest here from time to time. 

I hesitate to suggest this, but since I already did (see my “Programming Paradigms” column 
elsewhere in this issue), I guess it’s too late for reconsideration. If you have written or come 
across any song parodies that deal with programming themes, send them my way. I haven't 
created a web page for them yet, and I don’t know for sure that I will, but that’s the idea. My 
hesitation comes from my poetic sensitivity. I can’t write poetry, can hardly carry a tune, but I 
was cursed with an ear for meter. Poetry that tries to follow some meter and fails hurts my ears. I 
suspect I’m inviting some pain. We'll see. 

By the way, Reid Byers offers a more high-tone theme for my Hall of Flame web site: 


I think what Roger Price was talking about (and I remember Grump fondly) is the same thing 
Barbara Tuchmann wrote of in her wonderful book, The March of Folly. Tachmann defines folly as 
people acting against their own self-interest. Her historic examples include The Trojan Horse, 

' England during the American Revolution, the U.S. in Vietnam. Thought this might make a good 
working definition for your project. 


The March of Folly. Cool. Thanks, Reid. 


Hilal Sicade 


Michael Swaine 
editor-at-large 
mswaine@cruzio.com 


Dr. Dobb's Journal, July 1997 
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All other product names are trademarks of their respect 
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ON TIME. ON BUDGET. 


ON DELPHI. 


DELPHI 3. THIS CHANGES EVERYTHING. 





Is your development too complex? Are your budgets tight? Schedules impossible? People 
overworked? Do you depend on an increasing number of applications to run your business, talk 
to your customers, link in suppliers? Now you can turn all your problems into opportunities— 


with Delphi” 3. 


Delphi 3 adds more than 50 significant technologies to help you make effective business 
decisions, scale with growth, get products to market quickly, and increase overall productivity. 


Delphi 3 innovations include: 


e One-step ActiveX creation for enterprise-wide reusable components 

e BusinessInsight for integrated Decision Support development 

e CodelInsight Wizards for ease-of-use and increased productivity 

e MIDAS” Broker technologies for 24x7 business-critical applications 

e WebBroker for HTML delivery of database information to any browser on any client 

e High-performance native database drivers for Oracle, Sybase, Informix, DB2, AS/400, 
InterBase? MS SOL Server, and MS Access. 


Delphi continues to set the standard for high productivity, rapid development of high- 


performance client, server, and multi-tier applications for the enterprise, individual, and Internet. 


Get today what other tools are promising tomorrow. Call Borland at 1-800-336-6464, ext. 52019, 


or visit us at Www.borland.com/delphi 


Copyright © 1997 Borland International, Inc. All rights reserved. All Borland product names are trademarks of Borland International, Inc. BI 10111 
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